freelang-editor 11.7.4

package/src/_mongodb_helper.js

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+// MongoDB Driver Helper — FreeLang v11
+// High-level MongoDB 작업 + 트랜잭션 지원
+// 인자: node _mongodb_helper.js '<JSON 요청>'
+
+const { MongoClient, ObjectId } = require("mongodb");
+const { argv } = process;
+
+const request = argv[2] ? JSON.parse(argv[2]) : {};
+
+// 연결 URI 캐시 (같은 프로세스 내 재사용 불가, 매 호출마다 새 연결)
+async function withClient(uri, timeout, fn) {
+  const client = new MongoClient(uri, {
+    serverSelectionTimeoutMS: timeout,
+    connectTimeoutMS: timeout,
+    socketTimeoutMS: timeout,
+  });
+  try {
+    await client.connect();
+    const result = await fn(client);
+    return result;
+  } finally {
+    await client.close();
+  }
+}
+
+function makeUri(host, port, user, pass, authDb) {
+  if (user && pass) {
+    const creds = `${encodeURIComponent(user)}:${encodeURIComponent(pass)}`;
+    return `mongodb://${creds}@${host}:${port}/${authDb || "admin"}`;
+  }
+  return `mongodb://${host}:${port}`;
+}
+
+// ObjectId 문자열 변환 (재귀)
+function serializeDoc(doc) {
+  if (!doc || typeof doc !== "object") return doc;
+  if (Array.isArray(doc)) return doc.map(serializeDoc);
+  const out = {};
+  for (const [k, v] of Object.entries(doc)) {
+    if (v instanceof ObjectId) out[k] = v.toString();
+    else if (v && typeof v === "object" && v.constructor?.name === "ObjectId") out[k] = v.toString();
+    else if (v && typeof v === "object") out[k] = serializeDoc(v);
+    else out[k] = v;
+  }
+  return out;
+}
+
+// _id 문자열 → ObjectId 변환 (필터에서)
+function parseFilter(filter) {
+  if (!filter || typeof filter !== "object") return filter || {};
+  const out = { ...filter };
+  if (out._id && typeof out._id === "string" && out._id.length === 24) {
+    try { out._id = new ObjectId(out._id); } catch {}
+  }
+  return out;
+}
+
+async function handleRequest(req) {
+  const {
+    method,
+    host = "localhost",
+    port = 27017,
+    user,
+    pass,
+    authDb,
+    db: dbName,
+    collection: collName,
+    filter = {},
+    doc,
+    docs,
+    update,
+    pipeline,
+    ops,
+    options = {},
+    timeout = 10000,
+    limit,
+    skip,
+    sort,
+    projection,
+  } = req;
+
+  const uri = makeUri(host, port, user, pass, authDb);
+
+  switch (method) {
+    // ── 연결 테스트 ────────────────────────────────────────────
+    case "ping": {
+      return withClient(uri, timeout, async (client) => {
+        await client.db("admin").command({ ping: 1 });
+        return { ok: true };
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    // ── 단건 조회 ─────────────────────────────────────────────
+    case "find_one": {
+      return withClient(uri, timeout, async (client) => {
+        const col = client.db(dbName).collection(collName);
+        const doc = await col.findOne(parseFilter(filter), { projection });
+        return { ok: true, doc: doc ? serializeDoc(doc) : null };
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    // ── 다건 조회 ─────────────────────────────────────────────
+    case "find_many": {
+      return withClient(uri, timeout, async (client) => {
+        const col = client.db(dbName).collection(collName);
+        let cursor = col.find(parseFilter(filter), { projection });
+        if (sort) cursor = cursor.sort(sort);
+        if (skip) cursor = cursor.skip(skip);
+        if (limit) cursor = cursor.limit(limit);
+        const docs = await cursor.toArray();
+        return { ok: true, docs: docs.map(serializeDoc), count: docs.length };
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    // ── 카운트 ────────────────────────────────────────────────
+    case "count": {
+      return withClient(uri, timeout, async (client) => {
+        const col = client.db(dbName).collection(collName);
+        const n = await col.countDocuments(parseFilter(filter));
+        return { ok: true, count: n };
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    // ── 단건 삽입 ─────────────────────────────────────────────
+    case "insert_one": {
+      return withClient(uri, timeout, async (client) => {
+        const col = client.db(dbName).collection(collName);
+        const r = await col.insertOne(doc);
+        return { ok: true, inserted_id: r.insertedId.toString() };
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    // ── 다건 삽입 ─────────────────────────────────────────────
+    case "insert_many": {
+      return withClient(uri, timeout, async (client) => {
+        const col = client.db(dbName).collection(collName);
+        const r = await col.insertMany(docs);
+        return {
+          ok: true,
+          inserted_count: r.insertedCount,
+          inserted_ids: Object.values(r.insertedIds).map(id => id.toString()),
+        };
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    // ── 단건 수정 ─────────────────────────────────────────────
+    case "update_one": {
+      return withClient(uri, timeout, async (client) => {
+        const col = client.db(dbName).collection(collName);
+        const r = await col.updateOne(parseFilter(filter), update, options);
+        return { ok: true, matched: r.matchedCount, modified: r.modifiedCount };
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    // ── 다건 수정 ─────────────────────────────────────────────
+    case "update_many": {
+      return withClient(uri, timeout, async (client) => {
+        const col = client.db(dbName).collection(collName);
+        const r = await col.updateMany(parseFilter(filter), update, options);
+        return { ok: true, matched: r.matchedCount, modified: r.modifiedCount };
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    // ── 단건 삭제 ─────────────────────────────────────────────
+    case "delete_one": {
+      return withClient(uri, timeout, async (client) => {
+        const col = client.db(dbName).collection(collName);
+        const r = await col.deleteOne(parseFilter(filter));
+        return { ok: true, deleted: r.deletedCount };
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    // ── 다건 삭제 ─────────────────────────────────────────────
+    case "delete_many": {
+      return withClient(uri, timeout, async (client) => {
+        const col = client.db(dbName).collection(collName);
+        const r = await col.deleteMany(parseFilter(filter));
+        return { ok: true, deleted: r.deletedCount };
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    // ── Aggregation Pipeline ───────────────────────────────────
+    case "aggregate": {
+      return withClient(uri, timeout, async (client) => {
+        const col = client.db(dbName).collection(collName);
+        const docs = await col.aggregate(pipeline).toArray();
+        return { ok: true, docs: docs.map(serializeDoc), count: docs.length };
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    // ── 트랜잭션 ──────────────────────────────────────────────
+    // ops: [{method, db, collection, ...}, ...]
+    // 모든 ops 성공 시 commit, 하나라도 실패 시 abort
+    case "transaction": {
+      return withClient(uri, timeout, async (client) => {
+        const session = client.startSession();
+        const results = [];
+        try {
+          await session.withTransaction(async () => {
+            for (const op of ops) {
+              const col = client.db(op.db || dbName).collection(op.collection || collName);
+              const opFilter = parseFilter(op.filter || {});
+
+              if (op.method === "insert_one") {
+                const r = await col.insertOne(op.doc, { session });
+                results.push({ ok: true, inserted_id: r.insertedId.toString() });
+              } else if (op.method === "insert_many") {
+                const r = await col.insertMany(op.docs, { session });
+                results.push({ ok: true, inserted_count: r.insertedCount });
+              } else if (op.method === "update_one") {
+                const r = await col.updateOne(opFilter, op.update, { session, ...op.options });
+                results.push({ ok: true, matched: r.matchedCount, modified: r.modifiedCount });
+              } else if (op.method === "update_many") {
+                const r = await col.updateMany(opFilter, op.update, { session, ...op.options });
+                results.push({ ok: true, matched: r.matchedCount, modified: r.modifiedCount });
+              } else if (op.method === "delete_one") {
+                const r = await col.deleteOne(opFilter, { session });
+                results.push({ ok: true, deleted: r.deletedCount });
+              } else if (op.method === "delete_many") {
+                const r = await col.deleteMany(opFilter, { session });
+                results.push({ ok: true, deleted: r.deletedCount });
+              } else if (op.method === "find_one") {
+                const d = await col.findOne(opFilter, { session });
+                results.push({ ok: true, doc: d ? serializeDoc(d) : null });
+              } else {
+                throw new Error(`Unknown tx op: ${op.method}`);
+              }
+            }
+          });
+          return { ok: true, committed: true, results };
+        } catch (err) {
+          return { ok: false, error: err.message, aborted: true, results };
+        } finally {
+          await session.endSession();
+        }
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    // ── 인덱스 생성 ───────────────────────────────────────────
+    case "create_index": {
+      return withClient(uri, timeout, async (client) => {
+        const col = client.db(dbName).collection(collName);
+        const name = await col.createIndex(filter, options);
+        return { ok: true, name };
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    // ── 컬렉션 목록 ───────────────────────────────────────────
+    case "list_collections": {
+      return withClient(uri, timeout, async (client) => {
+        const cols = await client.db(dbName).listCollections().toArray();
+        return { ok: true, collections: cols.map(c => c.name) };
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    // ── 하위 호환: Wire Protocol 연결 테스트 ─────────────────
+    case "connect": {
+      return withClient(uri, timeout, async () => {
+        return { ok: true };
+      }).catch(err => ({ ok: false, error: err.message }));
+    }
+
+    default:
+      return { ok: false, error: `Unknown method: ${method}` };
+  }
+}
+
+(async () => {
+  const result = await handleRequest(request);
+  console.log(JSON.stringify(result));
+})();

package/src/_stdlib-signatures.json

@@ -0,0 +1 @@
+[{"module":"agent","name":"agent_create","params":"name","returns":"AgentState"},{"module":"agent","name":"agent_set","params":"agent key value","returns":"AgentState (immutable update)"},{"module":"agent","name":"agent_get","params":"agent key","returns":"any"},{"module":"agent","name":"agent_update","params":"agent updates","returns":"AgentState (merge multiple keys)"},{"module":"agent","name":"agent_steps","params":"agent","returns":"number"},{"module":"agent","name":"agent_status","params":"agent","returns":"string"},{"module":"agent","name":"agent_done","params":"agent","returns":"boolean"},{"module":"agent","name":"agent_add_tool","params":"agent toolName fn","returns":"AgentState"},{"module":"agent","name":"agent_call_tool","params":"agent toolName ...args","returns":"any"},{"module":"agent","name":"agent_tools","params":"agent","returns":"[string] (list registered tool names)"},{"module":"agent","name":"agent_push_history","params":"agent entry","returns":"AgentState"},{"module":"agent","name":"agent_history","params":"agent","returns":"[AgentHistoryEntry]"},{"module":"agent","name":"agent_history_last","params":"agent n","returns":"[AgentHistoryEntry] (last n entries)"},{"module":"agent","name":"agent_history_type","params":"agent type","returns":"[AgentHistoryEntry] (filter by type)"},{"module":"agent","name":"plan_create","params":"steps","returns":"Plan"},{"module":"agent","name":"plan_next","params":"plan","returns":"string | null (current step or null if done)"},{"module":"agent","name":"plan_advance","params":"plan result","returns":"Plan (mark current step done, move to next)"},{"module":"agent","name":"plan_done","params":"plan","returns":"boolean"},{"module":"agent","name":"plan_progress","params":"plan","returns":"number (0.0 - 1.0)"},{"module":"agent","name":"plan_results","params":"plan","returns":"{step: result}"},{"module":"agent","name":"observe","params":"key value context","returns":"context (accumulate observations)"},{"module":"agent","name":"summarize","params":"context","returns":"string (human/AI readable summary of context)"},{"module":"agent","name":"context_create","params":"","returns":"{} (empty context)"},{"module":"agent","name":"context_merge","params":"ctx1 ctx2","returns":"context"},{"module":"ai-workflow","name":"ai-stream","params":"prompt onChunk [model]","returns":"null  (콜백으로 청크 전달)"},{"module":"ai-workflow","name":"ollama","params":"prompt [model]","returns":"string  (로컬 LLM 직접 호출)"},{"module":"ai-workflow","name":"ollama-models","params":"","returns":"[string]  (설치된 모델 목록)"},{"module":"ai-workflow","name":"ai-render","params":"template vars","returns":"string"},{"module":"bits","name":"bit_and","params":"a b","returns":"number (bitwise AND: a & b)"},{"module":"bits","name":"bit_or","params":"a b","returns":"number (bitwise OR: a | b)"},{"module":"bits","name":"bit_xor","params":"a b","returns":"number (bitwise XOR: a ^ b)"},{"module":"bits","name":"bit_not","params":"a","returns":"number (bitwise NOT: ~a)"},{"module":"bits","name":"bit_shl","params":"a n","returns":"number (shift left: a << n)"},{"module":"bits","name":"bit_shr","params":"a n","returns":"number (unsigned right shift: a >>> n)"},{"module":"bits","name":"bit_sar","params":"a n","returns":"number (arithmetic right shift: a >> n)"},{"module":"bits","name":"bit_popcount","params":"a","returns":"number (count set bits)"},{"module":"bits","name":"bit_test","params":"a n","returns":"boolean (test bit at position n)"},{"module":"bits","name":"bit_set","params":"a n","returns":"number (set bit at position n)"},{"module":"bits","name":"bit_clear","params":"a n","returns":"number (clear bit at position n)"},{"module":"bits","name":"bit_rotate_left","params":"a n","returns":"number (rotate left: (a << n) | (a >>> (32-n)))"},{"module":"bits","name":"bit_rotate_right","params":"a n","returns":"number (rotate right: (a >>> n) | (a << (32-n)))"},{"module":"browser","name":"dom_select","params":"selector","returns":"Element | null"},{"module":"browser","name":"dom_select_all","params":"selector","returns":"[Element]"},{"module":"browser","name":"dom_by_id","params":"id","returns":"Element | null"},{"module":"browser","name":"dom_text","params":"el","returns":"string"},{"module":"browser","name":"dom_html","params":"el","returns":"string"},{"module":"browser","name":"dom_attr","params":"el attr","returns":"string"},{"module":"browser","name":"dom_val","params":"el","returns":"string  (input value)"},{"module":"browser","name":"dom_set_text","params":"el text","returns":"null"},{"module":"browser","name":"dom_set_html","params":"el html","returns":"null"},{"module":"browser","name":"dom_set_attr","params":"el attr value","returns":"null"},{"module":"browser","name":"dom_set_val","params":"el value","returns":"null  (input)"},{"module":"browser","name":"dom_set_style","params":"el prop value","returns":"null"},{"module":"browser","name":"dom_add_class","params":"el cls","returns":"null"},{"module":"browser","name":"dom_remove_class","params":"el cls","returns":"null"},{"module":"browser","name":"dom_toggle_class","params":"el cls","returns":"boolean"},{"module":"browser","name":"dom_has_class","params":"el cls","returns":"boolean"},{"module":"browser","name":"dom_create","params":"tag","returns":"Element"},{"module":"browser","name":"dom_append","params":"parent child","returns":"null"},{"module":"browser","name":"dom_prepend","params":"parent child","returns":"null"},{"module":"browser","name":"dom_remove","params":"el","returns":"null"},{"module":"browser","name":"dom_show","params":"el","returns":"null"},{"module":"browser","name":"dom_hide","params":"el","returns":"null"},{"module":"browser","name":"dom_toggle","params":"el","returns":"null"},{"module":"browser","name":"event_on","params":"el event handlerName","returns":"null  (FL 함수명으로 등록)"},{"module":"browser","name":"event_off","params":"el event handlerName","returns":"null"},{"module":"browser","name":"event_target","params":"e","returns":"Element"},{"module":"browser","name":"event_val","params":"e","returns":"string  (input 이벤트에서 값 추출)"},{"module":"browser","name":"event_prevent","params":"e","returns":"null"},{"module":"browser","name":"event_stop","params":"e","returns":"null"},{"module":"browser","name":"fetch_get","params":"url","returns":"{ok, status, data}  (동기 불가 → Promise 반환)"},{"module":"browser","name":"fetch_post","params":"url body","returns":"{ok, status, data}"},{"module":"browser","name":"fetch_put","params":"url body","returns":"{ok, status, data}"},{"module":"browser","name":"fetch_delete","params":"url","returns":"{ok, status, data}"},{"module":"browser","name":"storage_set","params":"key value","returns":"null"},{"module":"browser","name":"storage_get","params":"key","returns":"string | null"},{"module":"browser","name":"storage_remove","params":"key","returns":"null"},{"module":"browser","name":"storage_clear","params":"","returns":"null"},{"module":"browser","name":"browser_url","params":"","returns":"string"},{"module":"browser","name":"browser_path","params":"","returns":"string"},{"module":"browser","name":"browser_go","params":"url","returns":"null"},{"module":"browser","name":"browser_push","params":"url","returns":"null  (history API)"},{"module":"browser","name":"browser_reload","params":"","returns":"null"},{"module":"browser","name":"browser_alert","params":"msg","returns":"null"},{"module":"browser","name":"browser_confirm","params":"msg","returns":"boolean"},{"module":"browser","name":"browser_title","params":"","returns":"string"},{"module":"browser","name":"browser_set_title","params":"title","returns":"null"},{"module":"browser","name":"wcrypto_random_hex","params":"n","returns":"string  (n 바이트 hex)"},{"module":"browser","name":"wcrypto_sha256","params":"str","returns":"Promise<string>"},{"module":"browser","name":"browser_timeout","params":"ms handlerName","returns":"id"},{"module":"browser","name":"browser_interval","params":"ms handlerName","returns":"id"},{"module":"browser","name":"browser_clear_timer","params":"id","returns":"null"},{"module":"capture-error","name":"capture_error_args","params":"fn args context?","returns":"{ok, result, error?}"},{"module":"capture-error","name":"error_log","params":"","returns":"[{message, name, stack, timestamp, context?}, ...]"},{"module":"capture-error","name":"error_log_clear","params":"","returns":"count cleared"},{"module":"capture-error","name":"error_log_last","params":"n?","returns":"last n errors (default 10)"},{"module":"capture-error","name":"error_count","params":"","returns":"number of captured errors"},{"module":"capture-error","name":"make_error","params":"message name? code?","returns":"plain object"},{"module":"capture-error","name":"error_message","params":"err","returns":"string"},{"module":"capture-error","name":"error_stack","params":"err","returns":"[string]"},{"module":"capture-error","name":"retry","params":"fn attempts delay_ms?","returns":"{ok, result, attempts_used, error?}"},{"module":"collection","name":"arr_flatten","params":"arr","returns":"[any]  (flatten one level deep)"},{"module":"collection","name":"arr_flatten_deep","params":"arr","returns":"[any]  (flatten all levels)"},{"module":"collection","name":"arr_zip","params":"arr1 arr2","returns":"[[a,b]]  (zip two arrays into pairs)"},{"module":"collection","name":"arr_unique","params":"arr","returns":"[any]  (deduplicate, preserves order)"},{"module":"collection","name":"arr_chunk","params":"arr size","returns":"[[any]]  (split into chunks of size)"},{"module":"collection","name":"arr_take","params":"arr n","returns":"[any]  (first n elements)"},{"module":"collection","name":"arr_drop","params":"arr n","returns":"[any]  (all but first n elements)"},{"module":"collection","name":"arr_sum","params":"arr","returns":"number"},{"module":"collection","name":"arr_avg","params":"arr","returns":"number"},{"module":"collection","name":"arr_min","params":"arr","returns":"number"},{"module":"collection","name":"arr_max","params":"arr","returns":"number"},{"module":"collection","name":"arr_group_by","params":"arr key","returns":"{key: [items]}  (group objects by a key)"},{"module":"collection","name":"arr_sort_by","params":"arr key","returns":"[any]  (sort objects by a key, ascending)"},{"module":"collection","name":"arr_sort_by_desc","params":"arr key","returns":"[any]  (descending)"},{"module":"collection","name":"frequencies","params":"arr","returns":"{value: count}  (count occurrences of each value)"},{"module":"collection","name":"arr_count_by","params":"arr key","returns":"{key: count}  (count by key value)"},{"module":"collection","name":"arr_pluck","params":"arr key","returns":"[any]  (extract field from each object)"},{"module":"collection","name":"arr_index_by","params":"arr key","returns":"{key: item}  (index objects by unique key)"},{"module":"collection","name":"retry","params":"n fn","returns":"any  (call fn(), retry up to n times on error)"},{"module":"collection","name":"retry_silent","params":"n fn","returns":"any|null  (retry n times, return null on final failure)"},{"module":"collection","name":"memoize","params":"fn","returns":"fn  (return memoized version of fn, keyed by JSON args)"},{"module":"collection","name":"once","params":"fn","returns":"fn  (return version of fn that only executes once)"},{"module":"collection","name":"tap","params":"value fn","returns":"value  (call fn(value) for side effects, return value unchanged)"},{"module":"collection","name":"range","params":"start end","returns":"[number]  (inclusive start, exclusive end)"},{"module":"collection","name":"range_step","params":"start end step","returns":"[number]"},{"module":"collection","name":"repeat","params":"n value","returns":"[value]  (array of n copies of value)"},{"module":"collection","name":"arr_includes","params":"arr item","returns":"boolean  (deep equality check)"},{"module":"collection","name":"arr_index_of","params":"arr item","returns":"number  (-1 if not found)"},{"module":"collection","name":"arr_remove","params":"arr item","returns":"[any]  (remove first occurrence)"},{"module":"crypto-rsa","name":"crypto_rsa_generate","params":"bits","returns":"map (publicKey/privateKey PEM)"},{"module":"crypto-rsa","name":"crypto_rsa_sign","params":"private_pem data","returns":"string (base64url 서명)"},{"module":"crypto-rsa","name":"crypto_rsa_verify","params":"public_pem data signature_b64url","returns":"boolean"},{"module":"crypto-rsa","name":"pkce_s256","params":"verifier","returns":"string (PKCE S256 challenge: base64url(SHA256(verifier_bytes)))"},{"module":"crypto-rsa","name":"crypto_rsa_public_to_jwk","params":"public_pem kid","returns":"map (kty/n/e/kid/alg/use)"},{"module":"crypto","name":"sha256","params":"str","returns":"string (hex digest)"},{"module":"crypto","name":"sha256_short","params":"str","returns":"string (first 8 chars, useful as short ID)"},{"module":"crypto","name":"md5","params":"str","returns":"string (hex digest, for checksums only)"},{"module":"crypto","name":"sha1","params":"str","returns":"string"},{"module":"crypto","name":"hmac_sha256","params":"key msg","returns":"string (hex digest)"},{"module":"crypto","name":"hash_eq","params":"hash1 hash2","returns":"boolean (timing-safe compare)"},{"module":"crypto","name":"base64_encode","params":"str","returns":"string"},{"module":"crypto","name":"base64_decode","params":"str","returns":"string"},{"module":"crypto","name":"base64url_encode","params":"str","returns":"string (URL-safe, no padding)"},{"module":"crypto","name":"base64url_decode","params":"str","returns":"string (URL-safe Base64 → UTF-8)"},{"module":"crypto","name":"hex_encode","params":"str","returns":"string"},{"module":"crypto","name":"hex_decode","params":"hex","returns":"string"},{"module":"crypto","name":"random_bytes","params":"n","returns":"string (hex, n bytes of randomness)"},{"module":"crypto","name":"random_int","params":"min max","returns":"number (inclusive)"},{"module":"crypto","name":"random_float","params":"","returns":"number (0.0 - 1.0)"},{"module":"crypto","name":"uuid_v4","params":"","returns":"string (random UUID)"},{"module":"crypto","name":"uuid_short","params":"","returns":"string (8-char short ID from random bytes)"},{"module":"crypto","name":"uuid_from_str","params":"str","returns":"string (deterministic ID from string content)"},{"module":"crypto","name":"is_uuid","params":"str","returns":"boolean"},{"module":"crypto","name":"regex_match","params":"str pattern","returns":"boolean"},{"module":"crypto","name":"regex_match_i","params":"str pattern","returns":"boolean (case insensitive)"},{"module":"crypto","name":"regex_find","params":"str pattern","returns":"string|null (first match)"},{"module":"crypto","name":"regex_find_all","params":"str pattern","returns":"[string] (all non-overlapping matches)"},{"module":"crypto","name":"regex_replace","params":"str pattern replacement","returns":"string"},{"module":"crypto","name":"regex_replace_first","params":"str pattern replacement","returns":"string (only first match)"},{"module":"crypto","name":"regex_extract","params":"str pattern","returns":"[string] (capture groups of first match)"},{"module":"crypto","name":"regex_extract_all","params":"str pattern","returns":"[[string]] (all matches with groups)"},{"module":"crypto","name":"regex_split","params":"str pattern","returns":"[string]"},{"module":"crypto","name":"regex_count","params":"str pattern","returns":"number (count of matches)"},{"module":"crypto","name":"extract_json","params":"str","returns":"any|null  (extract first JSON object/array from text)"},{"module":"crypto","name":"extract_code","params":"str lang","returns":"string|null  (extract code block from markdown)"},{"module":"crypto","name":"extract_emails","params":"str","returns":"[string]"},{"module":"crypto","name":"extract_urls","params":"str","returns":"[string]"},{"module":"crypto","name":"extract_numbers","params":"str","returns":"[number]"},{"module":"crypto","name":"is_email","params":"str","returns":"boolean"},{"module":"crypto","name":"is_url","params":"str","returns":"boolean"},{"module":"data","name":"json_get","params":"obj path","returns":"any  (dot-path access: \"user.name\" or \"items.0\")"},{"module":"data","name":"json_set","params":"obj path value","returns":"object (immutable update, returns new obj)"},{"module":"data","name":"json_merge","params":"obj1 obj2","returns":"object (shallow merge, obj2 wins on conflict)"},{"module":"data","name":"json_deep_merge","params":"obj1 obj2","returns":"object (deep recursive merge)"},{"module":"data","name":"json_keys","params":"obj","returns":"[string] (get keys of object)"},{"module":"data","name":"json_vals","params":"obj","returns":"[any] (get values of object)"},{"module":"data","name":"map-entries","params":"m","returns":"[[k,v],...] (introspection primitive — JS Map/plain object 모두 열거)"},{"module":"data","name":"map_entries","params":"m","returns":"[[k,v],...] (alias for map-entries)"},{"module":"data","name":"json_parse","params":"str","returns":"object (parse JSON string to object)"},{"module":"data","name":"json_str","params":"obj","returns":"string (serialize to JSON string, handles Maps)"},{"module":"data","name":"json_stringify","params":"obj","returns":"string (alias for json_str)"},{"module":"data","name":"json_pretty","params":"obj","returns":"string (pretty-print JSON, handles Maps)"},{"module":"data","name":"json_has","params":"obj key","returns":"boolean (check if key exists)"},{"module":"data","name":"json_del","params":"obj key","returns":"object (delete key, returns new obj)"},{"module":"data","name":"csv_parse","params":"str","returns":"[[string]] (parse CSV string to rows)"},{"module":"data","name":"csv_write","params":"rows","returns":"string (serialize rows to CSV string)"},{"module":"data","name":"csv_header","params":"rows","returns":"[string] (get first row as header)"},{"module":"data","name":"csv_to_objects","params":"rows","returns":"[{header: value}] (rows to named objects)"},{"module":"data","name":"csv-parse","params":"text [delimiter]","returns":"[[string]] (quoted fields 완전 지원)"},{"module":"data","name":"csv-parse-map","params":"text [delimiter]","returns":"[{header: val}] (헤더 포함 파싱)"},{"module":"data","name":"csv-stringify","params":"rows [delimiter]","returns":"string"},{"module":"data","name":"str_template","params":"template vars","returns":"string  ({key} → value substitution)"},{"module":"data","name":"str_lines","params":"str","returns":"[string] (split into lines)"},{"module":"data","name":"str_join_lines","params":"lines","returns":"string"},{"module":"data","name":"str_trim","params":"str","returns":"string"},{"module":"data","name":"str_words","params":"str","returns":"[string] (split by whitespace)"},{"module":"data","name":"str_count","params":"str sub","returns":"number (count occurrences of sub in str)"},{"module":"data","name":"number_format","params":"num decimals","returns":"string  (1234567 0 -> \"1,234,567\")"},{"module":"data","name":"to_fixed","params":"num decimals","returns":"string  (3.14159 2 -> \"3.14\")"},{"module":"data","name":"format_currency","params":"num code","returns":"string  (1234567 \"KRW\" -> \"₩1,234,567\")"},{"module":"data","name":"empty?","params":"x","returns":"boolean (배열/문자열/객체/nil 모두 지원)"},{"module":"data","name":"array-empty?","params":"x","returns":"boolean (배열만 확인)"},{"module":"data","name":"str_replace_in","params":"s old new","returns":"string (replaceAll, 인자 순서: s 먼저)"},{"module":"db","name":"db_get","params":"collection id","returns":"data or null"},{"module":"db","name":"db_all","params":"collection","returns":"array"},{"module":"db","name":"db_put","params":"collection id data","returns":"saved data"},{"module":"db","name":"db_delete","params":"collection id","returns":"boolean"},{"module":"db","name":"db_project","params":"name","returns":"project data or null  (kimdb shorthand)"},{"module":"db","name":"db_projects","params":"","returns":"project list"},{"module":"db","name":"db_insert","params":"dbPath table data","returns":"true"},{"module":"db","name":"db_update","params":"dbPath table data where","returns":"true"},{"module":"db","name":"db_delete_row","params":"dbPath table where","returns":"true"},{"module":"db","name":"db_count","params":"dbPath table","returns":"number"},{"module":"db","name":"db_tables","params":"dbPath","returns":"string[]"},{"module":"db","name":"db_create","params":"dbPath sql","returns":"true  (CREATE TABLE ...)"},{"module":"db","name":"db_close","params":"dbPath","returns":"true"},{"module":"distributed","name":"distributed_execute","params":"dtask","returns":"DistributedResult"},{"module":"distributed","name":"distributed_task_create","params":"items worker_count","returns":"DistributedTask"},{"module":"distributed","name":"distributed_task_set_fn","params":"dtask fn","returns":"DistributedTask (set task function)"},{"module":"error","name":"error_message","params":"err","returns":"string (get error message)"},{"module":"error","name":"error_type","params":"err","returns":"string (get error type/name)"},{"module":"error","name":"is_error","params":"value","returns":"boolean (check if value is an error)"},{"module":"error","name":"create_error","params":"message","returns":"error (create an error object)"},{"module":"error","name":"create_typed_error","params":"type message","returns":"error (create a typed error)"},{"module":"error","name":"error_stack","params":"err","returns":"string (get error stack trace)"},{"module":"error","name":"with_fallback","params":"try_fn fallback_fn","returns":"any (execute try_fn, fallback on error)"},{"module":"fd","name":"fd_open","params":"path mode","returns":"number (fd, mode: r/w/a)"},{"module":"fd","name":"fd_write","params":"fd data","returns":"boolean (write data to file descriptor)"},{"module":"fd","name":"fd_fsync","params":"fd","returns":"boolean (flush file descriptor to disk)"},{"module":"fd","name":"fd_close","params":"fd","returns":"boolean (close file descriptor)"},{"module":"fd","name":"fd_read","params":"fd bytes","returns":"string (read bytes from file descriptor)"},{"module":"fd","name":"fd_seek","params":"fd offset whence","returns":"number (whence: 0/1/2)"},{"module":"fd","name":"fd_flush","params":"","returns":"boolean (flush all open fds)"},{"module":"feed","name":"rss_feed","params":"meta items","returns":"<?xml ... <rss>...</rss>"},{"module":"feed","name":"atom_feed","params":"meta items","returns":"<?xml ... <feed>...</feed>"},{"module":"feed","name":"sitemap_xml","params":"baseUrl routes","returns":"<?xml ... <urlset>..."},{"module":"feed","name":"robots_txt","params":"options","returns":"\"User-agent: * ...\""},{"module":"feed","name":"jsonld_article","params":"article","returns":"<script type=\"application/ld+json\">...</script>"},{"module":"feed","name":"jsonld_breadcrumb","params":"items","returns":"schema.org BreadcrumbList"},{"module":"feed","name":"jsonld_organization","params":"org","returns":"schema.org Organization"},{"module":"file","name":"file_read","params":"filePath","returns":"string (read file content)"},{"module":"file","name":"file_write","params":"filePath content","returns":"boolean (write content to file)"},{"module":"file","name":"file_exists","params":"filePath","returns":"boolean (check if file exists)"},{"module":"file","name":"file_delete","params":"filePath","returns":"boolean (delete file)"},{"module":"file","name":"file_append","params":"filePath content","returns":"boolean (append content to file)"},{"module":"file","name":"file_copy","params":"src dest","returns":"boolean (copy file)"},{"module":"file","name":"dir_create","params":"dirPath","returns":"boolean (create directory)"},{"module":"file","name":"dir_list","params":"dirPath","returns":"[string] (list directory contents)"},{"module":"file","name":"dir_delete","params":"dirPath","returns":"boolean (delete directory - must be empty)"},{"module":"file","name":"file_size","params":"filePath","returns":"number (get file size in bytes)"},{"module":"file","name":"file_is_file","params":"filePath","returns":"boolean (check if path is a file)"},{"module":"file","name":"file_is_dir","params":"filePath","returns":"boolean (check if path is a directory)"},{"module":"file","name":"file_mtime","params":"filePath","returns":"number (get modification time as timestamp)"},{"module":"file","name":"file_ctime","params":"filePath","returns":"number (get creation time as timestamp)"},{"module":"file","name":"file_read_or","params":"filePath defaultVal","returns":"string | any (파일 없거나 오류 시 기본값 반환)"},{"module":"http-macro","name":"http_get_json","params":"url headers?","returns":"{ok, status, body}"},{"module":"http-macro","name":"http_post_json","params":"url body headers?","returns":"{ok, status, body}"},{"module":"http-macro","name":"http_ok?","params":"result","returns":"boolean"},{"module":"http-macro","name":"http_body","params":"result","returns":"parsed body or null"},{"module":"http-macro","name":"http_status","params":"result","returns":"number"},{"module":"http-server","name":"server_get","params":"path handlerName","returns":"null"},{"module":"http-server","name":"server_post","params":"path handlerName","returns":"null"},{"module":"http-server","name":"server_put","params":"path handlerName","returns":"null"},{"module":"http-server","name":"server_patch","params":"path handlerName","returns":"null"},{"module":"http-server","name":"server_delete","params":"path handlerName","returns":"null"},{"module":"http-server","name":"server_static","params":"dir [urlPrefix]","returns":"null  정적 파일 서빙 (server-static \"public\" \"/\")"},{"module":"http-server","name":"server_stop","params":"","returns":"null"},{"module":"http-server","name":"server_text","params":"text","returns":"response object"},{"module":"http-server","name":"server_status","params":"code body","returns":"response object"},{"module":"http-server","name":"server_html_cookie","params":"cookie html","returns":"response (Set-Cookie 헤더 포함 HTML 응답)"},{"module":"http-server","name":"server_set_cookie","params":"name value opts","returns":"cookie string (HttpOnly+Secure+SameSite 자동)"},{"module":"http-server","name":"server_redirect","params":"url","returns":"response (302 리다이렉트)"},{"module":"http-server","name":"server_redirect_cookie","params":"url cookie","returns":"response (302 리다이렉트 + Set-Cookie)"},{"module":"http-server","name":"server_header","params":"response key value","returns":"response (헤더 추가)"},{"module":"http-server","name":"server_options","params":"response","returns":"204 No Content (CORS preflight 응답)"},{"module":"http-server","name":"server_req_cookie","params":"req name","returns":"string | null (쿠키 값 읽기)"},{"module":"http-server","name":"server_wait_respond","params":"promise","returns":"response object (비동기 응답 대기)"},{"module":"http-server","name":"server_req_query","params":"req [key]","returns":"object or string"},{"module":"http-server","name":"server_req_files","params":"req","returns":"array of multipart files"},{"module":"http-server","name":"server_req_fields","params":"req","returns":"map of multipart text fields"},{"module":"http-server","name":"server_req_header","params":"req name","returns":"string"},{"module":"http-server","name":"server_req_headers","params":"req","returns":"object (전체 헤더 맵)"},{"module":"http-server","name":"server_req_param","params":"req name","returns":"string"},{"module":"http-server","name":"server_req_params","params":"req","returns":"object  (all URL params as an object)"},{"module":"http-server","name":"server_req_method","params":"req","returns":"string"},{"module":"http-server","name":"server_req_path","params":"req","returns":"string"},{"module":"http-server","name":"server_req_id","params":"","returns":"string | null (현재 요청 ID)"},{"module":"http-server","name":"server_hold_response","params":"reqId","returns":"null (응답 보류)"},{"module":"http-server","name":"server_send_held","params":"reqId status body","returns":"boolean (보류된 응답 전송)"},{"module":"http-server","name":"server_on_upgrade","params":"fnName","returns":"null (WS upgrade 핸들러 등록)"},{"module":"http-server","name":"server_on_ws_message","params":"fnName","returns":"null (클라이언트 WS 메시지 핸들러)"},{"module":"http-server","name":"server_on_ws_close","params":"fnName","returns":"null (클라이언트 WS 종료 핸들러)"},{"module":"http-server","name":"ws_send_to_client","params":"sessionId data [isBinary]","returns":"boolean"},{"module":"http-server","name":"ws_close_client","params":"sessionId [code]","returns":"null"},{"module":"http-server","name":"server_req_session_id","params":"req","returns":"string | null"},{"module":"http","name":"http_get","params":"url","returns":"{:status 200 :body \"...\"}"},{"module":"http","name":"http_post","params":"url body","returns":"{:status 200 :body \"...\"}"},{"module":"http","name":"http_post_form","params":"url body","returns":"{:status 200 :body \"...\"}"},{"module":"http","name":"http_get_bearer","params":"url token","returns":"{:status 200 :body \"...\"}"},{"module":"http","name":"http_put","params":"url body","returns":"{:status 200 :body \"...\"}"},{"module":"http","name":"http_patch","params":"url body","returns":"{:status 200 :body \"...\"}"},{"module":"http","name":"http_delete","params":"url","returns":"{:status 200 :body \"...\"}"},{"module":"http","name":"http_head","params":"url","returns":"{:status 200 :body \"\"}"},{"module":"http","name":"http_get_key","params":"url api-key","returns":"{:status 200 :body \"...\"}"},{"module":"http","name":"http_post_key","params":"url body api-key","returns":"{:status 200 :body \"...\"}"},{"module":"http","name":"http_status","params":"url","returns":"number (상태코드만)"},{"module":"http","name":"http_json","params":"url","returns":"{:status 200 :data {...} :error nil}"},{"module":"http","name":"http_header","params":"url header","returns":"string (특정 헤더만)"},{"module":"http","name":"http_with_timeout","params":"url timeout","returns":"{:status 200 :body \"...\"}"},{"module":"http","name":"http_post_json","params":"url data","returns":"{:status 200 :data {...}}"},{"module":"http","name":"http_put_json","params":"url data","returns":"{:status 200 :data {...}}"},{"module":"http","name":"http_request","params":"method url headers body","returns":"{:status 200 :body \"...\"}"},{"module":"http","name":"http_req_status","params":"method url headers body","returns":"number"},{"module":"http","name":"http_get_json","params":"url headers","returns":"{:status 200 :data {...}}"},{"module":"http","name":"http_get_json_bearer","params":"url token","returns":"{:status 200 :data {...}}"},{"module":"http","name":"http_post_bearer","params":"url body token","returns":"{:status 200 :body \"...\"}"},{"module":"http","name":"http_retry_post","params":"url body token retries","returns":"{:status 200 :body \"...\"}"},{"module":"http","name":"is_http_success","params":"status","returns":"boolean"},{"module":"http","name":"is_http_redirect","params":"status","returns":"boolean"},{"module":"http","name":"is_http_error","params":"status","returns":"boolean"},{"module":"http","name":"http-post-data","params":"url data","returns":"parsed JSON data | nil  (#12 해결)"},{"module":"mail","name":"mail_outbox_write","params":"dir to subject body","returns":"string (파일 경로)"},{"module":"mail","name":"mail_outbox_list","params":"dir","returns":"array (JSON 배열, 큐된 메시지)"},{"module":"mail","name":"mail_outbox_count","params":"dir","returns":"number"},{"module":"markdown","name":"markdown_to_html","params":"md","returns":"html string"},{"module":"markdown","name":"markdown_frontmatter","params":"md","returns":"{ fm: {...}, body: \"...\" }"},{"module":"markdown","name":"markdown_render_full","params":"md","returns":"{ fm, html }"},{"module":"matrix","name":"matrix_mul","params":"A B","returns":"[[number]]  (matrix multiplication)"},{"module":"matrix","name":"matrix_transpose","params":"A","returns":"[[number]]  (transpose matrix)"},{"module":"matrix","name":"vector_dot","params":"u v","returns":"number  (dot product)"},{"module":"matrix","name":"vector_add","params":"u v","returns":"[number]  (vector addition)"},{"module":"matrix","name":"vector_sub","params":"u v","returns":"[number]  (vector subtraction)"},{"module":"matrix","name":"vector_scale","params":"v s","returns":"[number]  (scalar multiplication)"},{"module":"matrix","name":"vector_norm","params":"v","returns":"number  (Euclidean norm / L2 norm)"},{"module":"matrix","name":"matrix_zeros","params":"rows cols","returns":"[[number]]  (create zero matrix)"},{"module":"matrix","name":"vector_zeros","params":"n","returns":"[number]  (create zero vector)"},{"module":"optional","name":"require_optional","params":"modName","returns":"true/false (설치 여부)"},{"module":"optional","name":"optional_call","params":"modName fnPath args","returns":"result or throws"},{"module":"optional","name":"optional_has?","params":"modName","returns":"boolean"},{"module":"optional","name":"optional_version","params":"modName","returns":"string or nil"},{"module":"perf","name":"profile_fn","params":"fn count","returns":"PerfResult"},{"module":"perf","name":"trace_expr","params":"fn label","returns":"TraceResult"},{"module":"perf","name":"perf_stats","params":"","returns":"PerfStats"},{"module":"perf","name":"now_ms","params":"","returns":"number"},{"module":"perf","name":"elapsed_ms","params":"start","returns":"number"},{"module":"perf","name":"bench","params":"fn iterations","returns":"{ms, ops_per_sec}"},{"module":"perf","name":"time_fn","params":"fn args...","returns":"{result, ms}"},{"module":"process","name":"shell_exec_stdout","params":"cmd cwd?","returns":"string | null (stdout만 반환, 실패 시 null)"},{"module":"queue-helpers","name":"queue_db_init","params":"db_path","returns":"bool  (WAL 모드 + busy_timeout 활성화)"},{"module":"resource","name":"res_cpu_load","params":"","returns":"[1m, 5m, 15m]"},{"module":"resource","name":"res_cpu_count","params":"","returns":"number"},{"module":"resource","name":"res_cpu_model","params":"","returns":"string"},{"module":"resource","name":"res_cpu_pct","params":"","returns":"number (1-min loadavg based, avoids busy wait)"},{"module":"resource","name":"res_mem","params":"","returns":"{total_mb, used_mb, free_mb, buffers_mb, cached_mb, available_mb}"},{"module":"resource","name":"res_mem_pct","params":"","returns":"number (used %)"},{"module":"resource","name":"res_disk","params":"","returns":"DiskInfo[]"},{"module":"resource","name":"res_disk_usage","params":"path","returns":"{total_gb, used_gb, avail_gb, use_pct}"},{"module":"resource","name":"res_procs","params":"","returns":"ProcessInfo[]  (top 20 by CPU)"},{"module":"resource","name":"res_find_proc","params":"name","returns":"ProcessInfo[]  (search by name substring)"},{"module":"resource","name":"res_proc_exists","params":"name","returns":"boolean"},{"module":"resource","name":"res_proc_pid","params":"name","returns":"number | null"},{"module":"resource","name":"res_proc_count","params":"name","returns":"number  (how many instances running)"},{"module":"resource","name":"res_ports","params":"","returns":"PortInfo[]  (all listening ports)"},{"module":"resource","name":"res_port_used","params":"port","returns":"boolean"},{"module":"resource","name":"res_port_info","params":"port","returns":"PortInfo | null"},{"module":"resource","name":"res_find_free_port","params":"start end","returns":"number | null  (first free port in range)"},{"module":"resource","name":"res_net","params":"","returns":"NetInterface[]"},{"module":"resource","name":"res_hostname","params":"","returns":"string"},{"module":"resource","name":"res_uptime_s","params":"","returns":"number  (system uptime in seconds)"},{"module":"resource","name":"res_pm2_list","params":"","returns":"ServiceInfo[]"},{"module":"resource","name":"res_pm2_find","params":"name","returns":"ServiceInfo | null"},{"module":"resource","name":"res_systemd_status","params":"name","returns":"ServiceInfo"},{"module":"resource","name":"res_kimdb_project","params":"name","returns":"Record | null  (query local kimdb)"},{"module":"resource","name":"res_kimdb_projects","params":"","returns":"Record[]  (all projects)"},{"module":"resource","name":"res_kimdb_health","params":"","returns":"boolean"},{"module":"resource","name":"res_snapshot","params":"","returns":"ResourceSnapshot  (complete server state, ~1s)"},{"module":"resource","name":"res_snapshot_report","params":"snapshot","returns":"string  (human/AI readable)"},{"module":"resource","name":"res_health_check","params":"","returns":"{ok, warnings, errors}"},{"module":"rest-crud","name":"route_info","params":"basePath","returns":"{base, param_name, supported_ops: [...]}"},{"module":"rest-crud","name":"path_param","params":"req paramName","returns":"string or nil"},{"module":"rest-crud","name":"rest_response","params":"status body","returns":"Map"},{"module":"rest-crud","name":"rest_ok","params":"body","returns":"Map (200)"},{"module":"rest-crud","name":"rest_created","params":"body","returns":"Map (201)"},{"module":"rest-crud","name":"rest_not_found","params":"msg","returns":"Map (404)"},{"module":"rest-crud","name":"rest_error","params":"status msg","returns":"Map"},{"module":"shell","name":"shell","params":"cmd","returns":"string (run command, return stdout)"},{"module":"shell","name":"shell_status","params":"cmd","returns":"number (run command, return exit code)"},{"module":"shell","name":"shell_ok","params":"cmd","returns":"boolean (returns true if exit code is 0)"},{"module":"shell","name":"shell_pipe","params":"cmd1 cmd2","returns":"string (pipe output of cmd1 into cmd2)"},{"module":"shell","name":"shell_capture","params":"cmd","returns":"{stdout, stderr, code} (capture all output)"},{"module":"shell","name":"shell_exists","params":"program","returns":"boolean (check if a program is in PATH)"},{"module":"shell","name":"shell_env","params":"varname","returns":"string | null (환경변수 없으면 null)"},{"module":"shell","name":"shell_cwd","params":"","returns":"string (current working directory)"},{"module":"time","name":"now","params":"","returns":"number (current timestamp ms)"},{"module":"time","name":"now_ms","params":"","returns":"number (ms since epoch, always returns number)"},{"module":"time","name":"now_iso","params":"","returns":"string (ISO 8601)"},{"module":"time","name":"now_unix","params":"","returns":"number (seconds since epoch)"},{"module":"time","name":"time_diff","params":"t1 t2","returns":"number (ms, positive if t2 > t1)"},{"module":"time","name":"time_since","params":"ts","returns":"number (ms elapsed since ts)"},{"module":"time","name":"time_ago","params":"ts","returns":"string (human-readable: \"3s ago\", \"2m ago\", \"1h ago\")"},{"module":"time","name":"date_parts","params":"ts","returns":"{year,month,day,hour,min,sec,ms,weekday}"},{"module":"time","name":"date_add","params":"ts unit n","returns":"number  (unit: \"ms\"|\"s\"|\"m\"|\"h\"|\"d\"|\"days\"|\"hours\"|\"minutes\"|\"months\"|\"years\"|\"weeks\"|\"seconds\")"},{"module":"time","name":"date_parse","params":"str","returns":"number  (\"2026-04-23\" | \"2026-04-23T12:00:00Z\" -> timestamp ms)"},{"module":"time","name":"sleep_ms","params":"ms","returns":"void  (synchronous spin-wait, short durations only)"},{"module":"time","name":"timer_start","params":"label","returns":"Timer"},{"module":"time","name":"timer_lap","params":"timer label","returns":"Timer (record a lap time)"},{"module":"time","name":"timer_elapsed","params":"timer","returns":"number (ms since start)"},{"module":"time","name":"timer_stop","params":"timer","returns":"{label, total_ms, laps}"},{"module":"time","name":"log_create","params":"name level","returns":"Logger  (level = minimum level to record)"},{"module":"time","name":"log_entry","params":"logger level msg data?","returns":"Logger"},{"module":"time","name":"log_info","params":"logger msg","returns":"Logger"},{"module":"time","name":"log_warn","params":"logger msg","returns":"Logger"},{"module":"time","name":"log_error","params":"logger msg","returns":"Logger"},{"module":"time","name":"log_debug","params":"logger msg","returns":"Logger"},{"module":"time","name":"log_filter","params":"logger level","returns":"[LogEntry]  (entries at or above level)"},{"module":"time","name":"log_count","params":"logger level","returns":"number"},{"module":"time","name":"log_last","params":"logger n","returns":"[LogEntry]"},{"module":"time","name":"log_dump","params":"logger","returns":"void  (print all entries to stdout)"},{"module":"time","name":"metrics_create","params":"name","returns":"Metrics"},{"module":"time","name":"metrics_record","params":"metrics key value","returns":"Metrics"},{"module":"time","name":"metrics_inc","params":"metrics key","returns":"Metrics  (increment counter by 1)"},{"module":"time","name":"metrics_inc_by","params":"metrics key n","returns":"Metrics"},{"module":"time","name":"metrics_count","params":"metrics key","returns":"number"},{"module":"time","name":"metrics_avg","params":"metrics key","returns":"number"},{"module":"time","name":"metrics_min","params":"metrics key","returns":"number"},{"module":"time","name":"metrics_max","params":"metrics key","returns":"number"},{"module":"time","name":"metrics_p95","params":"metrics key","returns":"number  (95th percentile)"},{"module":"time","name":"metrics_summary","params":"metrics","returns":"{key: {count, avg, min, max}}"},{"module":"timer","name":"set_interval","params":"fn ms","returns":"number (fn: function name string, ms: interval)"},{"module":"timer","name":"clear_interval","params":"timerId","returns":"boolean (stop periodic timer)"},{"module":"timer","name":"set_timeout","params":"fn ms","returns":"number (fn: function name string, ms: delay)"},{"module":"timer","name":"clear_timeout","params":"timerId","returns":"boolean (cancel one-time timer)"},{"module":"timer","name":"timer_count","params":"","returns":"number (returns count of active timers)"},{"module":"timer","name":"timer_clear_all","params":"","returns":"boolean (clear all active timers)"},{"module":"totp","name":"totp_secret_generate","params":"bytes","returns":"string (base32, default 20 bytes = 160 bits = 32 chars)"},{"module":"totp","name":"totp_now","params":"secret_b32","returns":"string (현재 시각의 6자리 코드, 디버그·등록용)"},{"module":"totp","name":"totp_uri","params":"label issuer secret_b32","returns":"string (otpauth://totp/... QR 코드 표준)"},{"module":"verify","name":"check_parens","params":"code","returns":"VerifyResult"},{"module":"verify","name":"verify_code","params":"code","returns":"{valid, error_count, first_error}"},{"module":"verify","name":"fix_parens","params":"code","returns":"자동 수정된 코드 (or original if already valid)"},{"module":"verify","name":"count_parens","params":"code","returns":"{open, close, balanced}"},{"module":"webauthn","name":"webauthn_challenge","params":"bytes","returns":"base64url string (32 bytes)"},{"module":"workflow","name":"workflow_create","params":"name steps","returns":"Workflow object"},{"module":"workflow","name":"workflow_step","params":"name fn options","returns":"WorkflowStep  (helper for defining steps)"},{"module":"workflow","name":"step-with-error","params":"step handler-fn","returns":"WorkflowStep (add error handler)"},{"module":"workflow","name":"step-with-fallback","params":"step value-or-fn","returns":"WorkflowStep (add fallback)"},{"module":"workflow","name":"step-with-timeout","params":"step ms","returns":"WorkflowStep (add timeout)"},{"module":"workflow","name":"step-when","params":"step condition-fn","returns":"WorkflowStep (add conditional)"},{"module":"workflow","name":"workflow_ok","params":"result","returns":"boolean"},{"module":"workflow","name":"workflow_get","params":"result key","returns":"any  (get value from result context)"},{"module":"workflow","name":"workflow_summary","params":"result","returns":"string  (human/AI readable summary)"},{"module":"workflow","name":"task_create","params":"goal","returns":"Task"},{"module":"workflow","name":"task_add_subtask","params":"task name","returns":"task"},{"module":"workflow","name":"task_complete_subtask","params":"task name result","returns":"task"},{"module":"workflow","name":"task_finish","params":"task result","returns":"task"},{"module":"workflow","name":"task_progress","params":"task","returns":"number (0.0-1.0)"},{"module":"workflow","name":"report_create","params":"title","returns":"Report"},{"module":"workflow","name":"report_add","params":"report section_name data","returns":"Report"},{"module":"workflow","name":"report_render","params":"report","returns":"string  (formatted text report)"}]

package/src/agent-chain.ts

@@ -0,0 +1,71 @@
+// agent-chain.ts — FreeLang v9 Phase 128: CHAIN-AGENTS 에이전트 체인 파이프라인
+// 여러 에이전트를 순서대로 연결하여 출력이 다음 에이전트의 입력이 되는 파이프라인
+
+export interface ChainAgent {
+  id: string;
+  process: (input: any) => any;
+}
+
+export interface ChainStep {
+  agentId: string;
+  input: any;
+  output: any;
+  duration: number;
+}
+
+export interface ChainResult {
+  finalOutput: any;
+  steps: ChainStep[];
+  success: boolean;
+  totalDuration: number;
+}
+
+export class AgentChain {
+  private agents: ChainAgent[] = [];
+
+  /** 에이전트 추가 (순서대로) */
+  add(agent: ChainAgent): this {
+    this.agents.push(agent);
+    return this;
+  }
+
+  /** 에이전트 목록 */
+  list(): string[] {
+    return this.agents.map(a => a.id);
+  }
+
+  /** 파이프라인 실행 */
+  run(initialInput: any): ChainResult {
+    const start = Date.now();
+    const steps: ChainStep[] = [];
+    let current = initialInput;
+    let success = true;
+
+    for (const agent of this.agents) {
+      const stepStart = Date.now();
+      try {
+        const output = agent.process(current);
+        steps.push({ agentId: agent.id, input: current, output, duration: Date.now() - stepStart });
+        current = output;
+      } catch (e) {
+        steps.push({ agentId: agent.id, input: current, output: null, duration: Date.now() - stepStart });
+        success = false;
+        break;
+      }
+    }
+
+    return { finalOutput: current, steps, success, totalDuration: Date.now() - start };
+  }
+
+  /** 에이전트 수 */
+  size(): number {
+    return this.agents.length;
+  }
+
+  /** 체인 초기화 */
+  clear(): void {
+    this.agents = [];
+  }
+}
+
+export const globalAgentChain = new AgentChain();