ummaya 0.2.3 → 0.2.5

package/README.md

@@ -15,7 +15,7 @@
 **Unified Multi-Ministry Agent for Your Administration.**
 읽으면, **엄마야**.
 
-UMMAYA is a terminal agent for Korean public-service workflows. You describe the outcome in natural language, and UMMAYA routes the request through four main tools: `find`, `locate`, `check`, and `send`.
+UMMAYA is a terminal agent for Korean public-service workflows. You describe the outcome in natural language, and UMMAYA routes the request through five main tools: `find`, `locate`, `check`, `send`, and `document`.
 
 Read the full documentation at [ummaya-docs.pages.dev/ko](https://ummaya-docs.pages.dev/ko/). Start with the [Korean user guide](https://ummaya-docs.pages.dev/ko/start/why-ummaya/) if you want the product purpose first, or use [llms.txt](https://ummaya-docs.pages.dev/llms.txt) when an agent needs machine-readable project context.
 
@@ -92,7 +92,7 @@ Live public-information flows are shown most often in the demo because they can
 
 ## Main Tools
 
-UMMAYA keeps the model-facing surface small. Instead of exposing dozens of agency-specific APIs directly to the LLM, it gives the agent four durable primitives and lets adapters handle ministry-specific details behind them.
+UMMAYA keeps the model-facing surface small. Instead of exposing dozens of agency-specific APIs directly to the LLM, it gives the agent five durable primitives and lets adapters handle ministry-specific details behind them.
 
 ### `locate`
 
@@ -142,6 +142,18 @@ Typical use:
 
 `send` is where UMMAYA moves beyond answer generation: if a live or permitted channel exists it calls that channel; if only a mock or official handoff is available it preserves the same receipt-shaped boundary and says so clearly.
 
+### `document`
+
+`document` is the public-form authoring harness. Korean administrative work often ends in a filled form — HWP, HWPX, PDF, OOXML, or ODF — and `document` inspects the source form, extracts its field schema, copies it for safe editing, fills and styles fields, validates against the public-form rules, and renders the result.
+
+Typical use:
+
+```text
+전입신고서 양식을 열어서 내 정보로 채워줘. 제출 전에 어떤 칸이 비었는지도 확인해줘.
+```
+
+`document` does not silently write a government form. Authoring is gated: the harness requires Evidence Fabric coverage and an explicit in-session approval before it fills or renders, and the terminal surfaces an approval review so a person confirms the work before it is committed.
+
 ## Permissioned Work
 
 UMMAYA separates public information from protected action.
@@ -152,6 +164,7 @@ UMMAYA separates public information from protected action.
 | Location resolution | Use live geocoding/address/region adapters when available. |
 | Identity and delegation | Use `check` to call the wrapped identity/consent channel, such as Mobile ID, MyData, certificates, or OmniOne-style QR/app verification. |
 | Certificates, payment, submission, correction | Use `send` with the delegation context when a live or mock channel is registered; otherwise hand off to the official path. |
+| Public-form authoring | Use `document` to inspect, fill, and render a Korean public form; stop for Evidence Fabric coverage and explicit approval before writing. |
 | API failure, zero result, missing authority | Stop clearly instead of inventing a result. |
 
 This is not a separate safety pitch. It is part of how `check` and `send` work: the model plans the task, calls the right wrapped public-service tools, and stops at the authority boundary instead of acting like a reference-only RAG answerer.
@@ -161,7 +174,8 @@ This is not a separate safety pitch. It is part of how `check` and `send` work:
 UMMAYA currently uses `LGAI-EXAONE/K-EXAONE-236B-A23B` through FriendliAI Serverless for LLM responses.
 
 - Model: [K-EXAONE-236B-A23B](https://huggingface.co/LGAI-EXAONE/K-EXAONE-236B-A23B)
-- Thinking channel: `UMMAYA_K_EXAONE_THINKING` default `false`; set it to `true` only for reasoning-channel diagnostics or benchmark runs.
+- Reasoning mode: `/reasoning` or `UMMAYA_K_EXAONE_REASONING_MODE` selects `fast`, `balanced`, `deep`, `diagnostic`, or `auto`.
+- Thinking channel: `UMMAYA_K_EXAONE_THINKING` default `false` remains as a legacy compatibility flag; set `/reasoning deep` or `UMMAYA_K_EXAONE_REASONING_MODE=deep` for reasoning-channel diagnostics or benchmark runs.
 - Model license: [K-EXAONE AI Model License Agreement](https://huggingface.co/LGAI-EXAONE/K-EXAONE-236B-A23B/blob/main/LICENSE)
 - Project license: [Apache License 2.0](LICENSE)
 

package/bin/ummaya

@@ -135,13 +135,22 @@ export function loadPackageDotenv(root, env = process.env) {
 
 export function buildBackendCommand(root) {
   const packagedPython = join(root, '.venv', 'bin', 'python')
-  if (existsSync(packagedPython)) {
+  if (canImportUmmayaCli(packagedPython)) {
     return [packagedPython, '-m', 'ummaya.cli', '--ipc', 'stdio']
   }
 
   return ['uv', '--directory', root, 'run', '--frozen', '--no-dev', 'ummaya', '--ipc', 'stdio']
 }
 
+export function canImportUmmayaCli(pythonPath) {
+  if (!existsSync(pythonPath)) return false
+  const result = spawnSync(pythonPath, ['-c', 'import ummaya.cli'], {
+    encoding: 'utf8',
+    stdio: ['ignore', 'ignore', 'ignore'],
+  })
+  return !result.error && result.status === 0
+}
+
 export function configurePackageEnv(root, env = process.env) {
   env.UMMAYA_PACKAGE_ROOT = root
   if (env.UMMAYA_ALLOW_BACKEND_CMD_OVERRIDE !== '1' || !env.UMMAYA_BACKEND_CMD_JSON) {

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "ummaya",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "ummaya",
-      "version": "0.2.3",
+      "version": "0.2.5",
       "license": "Apache-2.0",
       "dependencies": {
         "@alcalzone/ansi-tokenize": "^0.3.0",
@@ -38,6 +38,8 @@
         "@opentelemetry/sdk-trace-base": "^2.7.0",
         "@opentelemetry/semantic-conventions": "^1.40.0",
         "@pdf-lib/fontkit": "^1.1.1",
+        "@rhwp/core": "^0.7.13",
+        "@ssabrojs/hwpxjs": "0.4.0",
         "ajv": "^8.18.0",
         "asciichart": "^1.5.25",
         "auto-bind": "^5.0.1",
@@ -2137,6 +2139,12 @@
       "integrity": "sha512-oOAWABowe8EAbMyWKM0tYDKi8Yaox52D+HWZhAIJqQXbqe0xI/GV7FhLWqlEKreMkfDjshR5FKgi3mnle0h6Eg==",
       "license": "BSD-3-Clause"
     },
+    "node_modules/@rhwp/core": {
+      "version": "0.7.13",
+      "resolved": "https://registry.npmjs.org/@rhwp/core/-/core-0.7.13.tgz",
+      "integrity": "sha512-IrAubU8/gfFJwXEdTrq/zgfO50uKEuo3p/m4FkcwS7QYFMS94bAHhrBr3mxPsFv5rwqiskI68pJjqaS9K/be1A==",
+      "license": "MIT"
+    },
     "node_modules/@sec-ant/readable-stream": {
       "version": "0.4.1",
       "resolved": "https://registry.npmjs.org/@sec-ant/readable-stream/-/readable-stream-0.4.1.tgz",
@@ -2793,6 +2801,33 @@
         "node": ">=18.0.0"
       }
     },
+    "node_modules/@ssabrojs/hwpxjs": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/@ssabrojs/hwpxjs/-/hwpxjs-0.4.0.tgz",
+      "integrity": "sha512-tJ42NS2ywHOnhnFQ/i73hQb9xZRQGRItr4P6qJEN3C4UeSDwGLgZsa8AeSpyL+2pK8ZDKuzLWAXGjGVvVPOUuA==",
+      "license": "MIT",
+      "dependencies": {
+        "cfb": "^1.2.2",
+        "fast-xml-parser": "^5.2.5",
+        "htmlparser2": "^12.0.0",
+        "jszip": "^3.10.1",
+        "marked": "^18.0.2",
+        "pako": "^2.1.0"
+      },
+      "bin": {
+        "hwpx": "dist/cli.js",
+        "hwpxjs": "dist/cli.js"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@ssabrojs/hwpxjs/node_modules/pako": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/pako/-/pako-2.1.0.tgz",
+      "integrity": "sha512-w+eufiZ1WuJYgPXbV/PO3NCMEc3xqylkKHzp8bxp1uW4qaSNQUkwmLLEc3kKsfz8lpV1F8Ht3U1Cm+9Srog2ug==",
+      "license": "(MIT AND Zlib)"
+    },
     "node_modules/@types/mute-stream": {
       "version": "0.0.4",
       "resolved": "https://registry.npmjs.org/@types/mute-stream/-/mute-stream-0.0.4.tgz",
@@ -2859,6 +2894,15 @@
         "node": ">= 0.6"
       }
     },
+    "node_modules/adler-32": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/adler-32/-/adler-32-1.3.1.tgz",
+      "integrity": "sha512-ynZ4w/nUUv5rrsR8UUGoe1VC9hZj6V5hU9Qw1HlMDJGEJw5S7TfTErWTjMys6M7vr0YWcPqs3qAr4ss0nDfP+A==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
     "node_modules/agent-base": {
       "version": "9.0.0",
       "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-9.0.0.tgz",
@@ -3198,6 +3242,19 @@
         "node": "^18.12.0 || >= 20.9.0"
       }
     },
+    "node_modules/cfb": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/cfb/-/cfb-1.2.2.tgz",
+      "integrity": "sha512-KfdUZsSOw19/ObEWasvBP/Ac4reZvAGauZhs6S/gqNhXhI7cKwvlH7ulj+dOEYnca4bm4SGo8C1bTAQvnTjgQA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "adler-32": "~1.3.0",
+        "crc-32": "~1.2.0"
+      },
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
     "node_modules/chalk": {
       "version": "5.6.2",
       "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz",
@@ -3578,6 +3635,12 @@
         "node": ">=6.6.0"
       }
     },
+    "node_modules/core-util-is": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
+      "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==",
+      "license": "MIT"
+    },
     "node_modules/cors": {
       "version": "2.8.6",
       "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.6.tgz",
@@ -3595,6 +3658,18 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/crc-32": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/crc-32/-/crc-32-1.2.2.tgz",
+      "integrity": "sha512-ROmzCKrTnOwybPcJApAA6WBWij23HVfGVNKqqrZpuyZOHqK2CwHSvpGuyt/UNNvaIjEd8X5IFGp4Mh+Ie1IHJQ==",
+      "license": "Apache-2.0",
+      "bin": {
+        "crc32": "bin/crc32.njs"
+      },
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
     "node_modules/cross-spawn": {
       "version": "7.0.6",
       "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
@@ -3741,6 +3816,73 @@
         "node": ">=10"
       }
     },
+    "node_modules/dom-serializer": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-3.1.1.tgz",
+      "integrity": "sha512-4MEa38/QexBob6gFNwu+EGdWvhJ1OKuNwdYY3Y3NyeWDQfnGeDYQUDfIRzWu5B5gsv03so2Uxd28YC6zrsx3Lw==",
+      "license": "MIT",
+      "dependencies": {
+        "domelementtype": "^3.0.0",
+        "domhandler": "^6.0.0",
+        "entities": "^8.0.0"
+      },
+      "engines": {
+        "node": ">=20.19.0"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/cheeriojs/dom-serializer?sponsor=1"
+      }
+    },
+    "node_modules/domelementtype": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-3.0.0.tgz",
+      "integrity": "sha512-umCQid3jKbDmVjx8jGaW7uUykm4DEUeyV21hPxNMo2nV955DhUThwqyOIDtreepP31hl84X7G5U9ZfsWvIB3Pg==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fb55"
+        }
+      ],
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=20.19.0"
+      }
+    },
+    "node_modules/domhandler": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-6.0.1.tgz",
+      "integrity": "sha512-gYzvtM72ZtxQO0T048kd6HWSbbGCNOUwcnfQ01cqIJ4X2IYKFFHZ5mKvrQETcFXxsRObZulDaKmy//R7TPtsBg==",
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "domelementtype": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=20.19.0"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/fb55/domhandler?sponsor=1"
+      }
+    },
+    "node_modules/domutils": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/domutils/-/domutils-4.0.2.tgz",
+      "integrity": "sha512-qI4JLRKnSzqFqr7hAlS5xQDusBCjKSEG4t4+7aNrIQMHBcsC2TGEhuyABJdYkgSewL57PNLYEiibY2iPKhKpaA==",
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "dom-serializer": "^3.0.0",
+        "domelementtype": "^3.0.0",
+        "domhandler": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=20.19.0"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/fb55/domutils?sponsor=1"
+      }
+    },
     "node_modules/dunder-proto": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
@@ -3794,6 +3936,18 @@
         "once": "^1.4.0"
       }
     },
+    "node_modules/entities": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-8.0.0.tgz",
+      "integrity": "sha512-zwfzJecQ/Uej6tusMqwAqU/6KL2XaB2VZ2Jg54Je6ahNBGNH6Ek6g3jjNCF0fG9EWQKGZNddNjU5F1ZQn/sBnA==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=20.19.0"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
     "node_modules/env-paths": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-4.0.0.tgz",
@@ -4771,6 +4925,28 @@
         "node": ">=16.9.0"
       }
     },
+    "node_modules/htmlparser2": {
+      "version": "12.0.0",
+      "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-12.0.0.tgz",
+      "integrity": "sha512-Tz7u1i95/g2x2jz81+x0FBVhBhY5aRTvD3tXXdFaljuNdzDLJ8UGNRrTcj2cgQvAg3iW/h77Fz15nLW0L0CrZw==",
+      "funding": [
+        "https://github.com/fb55/htmlparser2?sponsor=1",
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fb55"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "domelementtype": "^3.0.0",
+        "domhandler": "^6.0.0",
+        "domutils": "^4.0.2",
+        "entities": "^8.0.0"
+      },
+      "engines": {
+        "node": ">=20.19.0"
+      }
+    },
     "node_modules/http-errors": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
@@ -4867,6 +5043,12 @@
         "node": ">= 4"
       }
     },
+    "node_modules/immediate": {
+      "version": "3.0.6",
+      "resolved": "https://registry.npmjs.org/immediate/-/immediate-3.0.6.tgz",
+      "integrity": "sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==",
+      "license": "MIT"
+    },
     "node_modules/indent-string": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-5.0.0.tgz",
@@ -5181,6 +5363,12 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/isarray": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
+      "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
+      "license": "MIT"
+    },
     "node_modules/isexe": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
@@ -5248,6 +5436,48 @@
         "graceful-fs": "^4.1.6"
       }
     },
+    "node_modules/jszip": {
+      "version": "3.10.1",
+      "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.10.1.tgz",
+      "integrity": "sha512-xXDvecyTpGLrqFrvkrUSoxxfJI5AH7U8zxxtVclpsUtMCq4JQ290LY8AW5c7Ggnr/Y/oK+bQMbqK2qmtk3pN4g==",
+      "license": "(MIT OR GPL-3.0-or-later)",
+      "dependencies": {
+        "lie": "~3.3.0",
+        "pako": "~1.0.2",
+        "readable-stream": "~2.3.6",
+        "setimmediate": "^1.0.5"
+      }
+    },
+    "node_modules/jszip/node_modules/readable-stream": {
+      "version": "2.3.8",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz",
+      "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==",
+      "license": "MIT",
+      "dependencies": {
+        "core-util-is": "~1.0.0",
+        "inherits": "~2.0.3",
+        "isarray": "~1.0.0",
+        "process-nextick-args": "~2.0.0",
+        "safe-buffer": "~5.1.1",
+        "string_decoder": "~1.1.1",
+        "util-deprecate": "~1.0.1"
+      }
+    },
+    "node_modules/jszip/node_modules/safe-buffer": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
+      "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
+      "license": "MIT"
+    },
+    "node_modules/jszip/node_modules/string_decoder": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
+      "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.1.0"
+      }
+    },
     "node_modules/jwa": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/jwa/-/jwa-2.0.1.tgz",
@@ -5269,6 +5499,15 @@
         "safe-buffer": "^5.0.1"
       }
     },
+    "node_modules/lie": {
+      "version": "3.3.0",
+      "resolved": "https://registry.npmjs.org/lie/-/lie-3.3.0.tgz",
+      "integrity": "sha512-UaiMJzeWRlEujzAuw5LokY1L5ecNQYZKfmyZ9L7wDHb/p5etKaxXhohBcrw0EYby+G/NA52vRSN4N39dxHAIwQ==",
+      "license": "MIT",
+      "dependencies": {
+        "immediate": "~3.0.5"
+      }
+    },
     "node_modules/locate-path": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz",
@@ -6081,6 +6320,12 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/process-nextick-args": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
+      "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==",
+      "license": "MIT"
+    },
     "node_modules/proper-lockfile": {
       "version": "4.1.2",
       "resolved": "https://registry.npmjs.org/proper-lockfile/-/proper-lockfile-4.1.2.tgz",
@@ -6540,6 +6785,12 @@
       "integrity": "sha512-KiKBS8AnWGEyLzofFfmvKwpdPzqiy16LvQfK3yv/fVH7Bj13/wl3JSR1J+rfgRE9q7xUJK4qvgS8raSOeLUehw==",
       "license": "ISC"
     },
+    "node_modules/setimmediate": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz",
+      "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==",
+      "license": "MIT"
+    },
     "node_modules/setprototypeof": {
       "version": "1.2.0",
       "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ummaya",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Conversational multi-agent harness for Korean public-service channels",
   "license": "Apache-2.0",
   "type": "module",
@@ -23,6 +23,8 @@
     "uv.lock",
     "docs/demo/**",
     "docs/plugins/security-review.md",
+    "specs/2803-document-production-hardening/contracts/document-tools.schema.json",
+    "tests/fixtures/documents/public_forms/baselines.yaml",
     "tests/fixtures/plugin_validation/checklist_manifest.yaml",
     "!**/.DS_Store",
     "!**/__pycache__/**",
@@ -98,6 +100,8 @@
     "@opentelemetry/sdk-trace-base": "^2.7.0",
     "@opentelemetry/semantic-conventions": "^1.40.0",
     "@pdf-lib/fontkit": "^1.1.1",
+    "@rhwp/core": "^0.7.13",
+    "@ssabrojs/hwpxjs": "0.4.0",
     "ajv": "^8.18.0",
     "asciichart": "^1.5.25",
     "auto-bind": "^5.0.1",

package/prompts/manifest.yaml

@@ -6,9 +6,9 @@ entries:
   path: compact_v1.md
 - prompt_id: session_guidance_v1
   version: 1
-  sha256: 063e92b54886d624a80170ae8c5f62498d2b7817daa2743db6753279578902b1
+  sha256: 5464ca763790332b2d6a3969151b43723ec51cc43bdeaed09074f7a0a1f62f98
   path: session_guidance_v1.md
 - prompt_id: system_v1
   version: 1
-  sha256: 0611f086efeaa50986521b9ded4bb30adf628cd51898dce340efc8a1ebec920c
+  sha256: b25e6d153c299f0b9ea67081b191e38de7a11dcfadc14db33473e9b53d476e2c
   path: system_v1.md

package/prompts/session_guidance_v1.md

@@ -1,3 +1,5 @@
-When the citizen's message names a district, neighborhood, landmark, or address, invoke the geocoding tool before any tool that takes an administrative code. Do not fill administrative region codes from memory; pass them only after a geocoding tool has produced them in this session. In UMMAYA's active tool surface, "geocoding tool" means the locate primitive and its registered locate adapters. Also call locate when the citizen names a campus, station, POI, or nearby-search anchor before any downstream adapter that needs coordinates, KMA nx/ny, administrative codes, or region names. Choose a registered locate adapter from <available_adapters>: use kakao_keyword_search for POIs and named places, kakao_address_search for structured road/jibun addresses, kakao_coord_to_region after coordinates when a region-mode adapter needs q0/q1, and JUSO/SGIS adapters only when their schema better matches the required identifier. Do not fill coordinates, KMA grids, administrative codes, or region names from memory; pass only values produced by a locate adapter in this session. When the citizen's request matches a registered adapter's purpose (accident statistics, emergency rooms, hospitals, weather observations, forecast data, welfare eligibility, authentication, submissions, etc.), invoke the appropriate primitive and adapter to fetch or perform the authoritative action; do not answer factual public-service queries from parametric memory. For current/today weather, call kma_current_observation with nx/ny from locate before final prose; call kma_forecast_fetch as a companion when the citizen also needs today's later forecast. For emergency-room search near a named place, first call locate with {"tool_id":"kakao_keyword_search","params":{"query":"<citizen-place-text>"}}, then call locate with {"tool_id":"kakao_coord_to_region","params":{"lat":"<locate lat>","lon":"<locate lon>"}} if the NMC adapter needs q0/q1 region-mode parameters. Always use tools for location-based factual queries even when you recognize the place name. Never call a tool with an empty or whitespace-only argument value.
+Prefer concrete adapter function calls when a registered adapter is loaded in the current tools[] list. A concrete adapter function is named by its tool_id and accepts exactly the schema fields from <available_adapters>; do not wrap {"tool_id": "...", "params": {...}} inside that concrete function. Use legacy root wrappers locate/find/check/send only when the concrete adapter function is not loaded and only the root primitive is available. When the citizen's message names a district, neighborhood, landmark, or address, invoke the geocoding tool before any tool that takes an administrative code. Do not fill administrative region codes from memory; pass them only after a geocoding tool has produced them in this session. In the active concrete tool surface, that geocoding tool should be the registered locate adapter function itself. Use kakao_keyword_search({"query":"<citizen-place-text>"}) for POIs and named places, kakao_address_search({"query":"<citizen-address>"}) for structured road/jibun addresses, kakao_coord_to_region({"lat":<locate lat>,"lon":<locate lon>}) after coordinates when a region-mode adapter needs q0/q1, and JUSO/SGIS adapters only when their schema better matches the required identifier. Do not fill coordinates, KMA grids, administrative codes, or region names from memory; pass only values produced by a locate adapter in this session. When the citizen's request matches a registered adapter's purpose (accident statistics, emergency rooms, hospitals, weather observations, forecast data, welfare eligibility, authentication, submissions, etc.), invoke the appropriate concrete adapter to fetch or perform the authoritative action; do not answer factual public-service queries from parametric memory. For current/today non-aviation weather, call kma_current_observation with nx/ny from locate before final prose; call kma_forecast_fetch as a companion when the citizen also needs today's later forecast. Aviation exception: when the citizen names METAR, SPECI, AMOS, RVR, runway, airport aviation weather, or a concrete KMA APIHub aviation adapter from <available_adapters>, do not route to kma_current_observation and do not call locate unless the selected adapter schema explicitly requires coordinates. Use the aviation adapter from <available_adapters> directly, usually kma_apihub_url_air_metar_decoded({"org":"K","help":1}) for Gimhae/RKPK decoded METAR. For emergency-room search near a named place, first call kakao_keyword_search({"query":"<citizen-place-text>"}), then call kakao_coord_to_region({"lat":<locate lat>,"lon":<locate lon>}) if the NMC adapter needs q0/q1 region-mode parameters. For collapse, unconsciousness, cardiac-arrest, or AED-relevant wording such as 사람이 쓰러졌어, after emergency-room search also call nmc_aed_site_locate before final prose when that adapter is surfaced; if AED returns no data or an upstream error, report that result with 119 guidance instead of substituting ER data. Always use tools for location-based factual queries even when you recognize the place name. Never call a tool with an empty or whitespace-only argument value.
+
+Treat ordinary airport flight-operation wording as aviation weather intent even when the citizen does not say METAR, AMOS, or 항공기상. Examples include 비행기, 항공편, 비행편, 이륙, 착륙, 결항, 지연, 운항, 뜰 만한가, flight, takeoff, landing, delay, or cancellation near an airport name. For those turns, prefer the KMA APIHub aviation adapter in <available_adapters> over locate plus kma_current_observation.
 
 Before each tool call, compare the citizen request with the selected adapter's input schema in <available_adapters>. Preserve every explicit constraint from the citizen request as a matching parameter when the schema exposes one: requested result count, radius or distance wording, date/time, institution type, category, specialty, keyword, administrative region, and other filter fields. Do not make a broad unfiltered call when the request is narrower and the adapter has an optional field for that narrowing. After a tool_result, verify that the returned collection still matches the citizen's stated constraints before writing final prose; if it does not, call the same selected adapter again with corrected schema-valid params instead of answering from the broad result.

package/prompts/system_v1.md

@@ -38,8 +38,8 @@
 
 <tool_usage>
 <primitives>
-- `locate(tool_id, params)` — 등록된 locate 어댑터를 골라 위치 / 주소 / 역 / 관공서 좌표 + 행정동 + POI 를 반환. 예: `locate(tool_id="kakao_keyword_search", params={"query":"동아대학교 승학캠퍼스"})`.
-- `find(tool_id, params)` — 외부 도메인 API 조회 도구 (기상청, HIRA, KOROAD 등). 백엔드가 사용자 발화 시점에 BM25 로 후보 어댑터를 사전 선별해 `<available_adapters>` 섹션에 inject 합니다 — LLM 은 그 목록에서 tool_id 를 골라 fetch 만 호출. `mode="search"` 는 backend internal 기능이므로 LLM 이 직접 호출 금지.
+- **Concrete adapter first** — tools[] 안에 concrete adapter function 이 있으면 function 이름은 `tool_id` 입니다. 그 function 은 adapter schema 필드만 받습니다. 예: `kakao_keyword_search({"query":"동아대학교 승학캠퍼스"})`, `kma_current_observation({"base_date":"YYYYMMDD","base_time":"HH00","nx":97,"ny":74})`. concrete adapter function 에 `{"tool_id": "...", "params": {...}}` 를 넣지 마십시오.
+- **Legacy root wrappers** — concrete adapter function 이 로드되지 않고 root primitive 만 있을 때만 `locate({"tool_id":"kakao_keyword_search","params":{"query":"동아대학교 승학캠퍼스"}})` 또는 `find({"tool_id":"kma_current_observation","params":{...}})` 형식을 사용합니다. `mode="search"` 는 backend internal 기능이므로 LLM 이 직접 호출 금지.
 - `check(tool_id, params)` — 인증 ceremony. `params = {scope_list, purpose_ko, purpose_en, session_id?}`. 반환 = `DelegationContext` (또는 any_id_sso 의 경우 `IdentityAssertion`).
 - `send(tool_id, params)` — OPAQUE-도메인 행정 모듈 호출. `params` 에 `delegation_context` (check 반환) + 어댑터별 payload. 접수번호 반환.
 **Public-data boundary**: 공개자료 `find` 조회가 성공했고 시민 발화에 인증/본인확인/동의/신청/제출/납부/신고 요구가 없으면 다음 turn 은 최종 답변입니다. 공개 의약품, 채용공고, 통계, 요금, 수질, 시설 목록 같은 read-only 결과를 "검증"하려고 `check` 를 추가 호출하지 마십시오.
@@ -77,14 +77,14 @@
 | 마이데이터 인증 / 거래내역 동의  | `mock_verify_mydata`                 | (해당 어댑터)                              | `mock_submit_module_public_mydata_action`   |
 | 공동·금융 통합 (default)         | `mock_verify_gongdong_injeungseo`    | (선택)                                     | (선택)                                       |
 | 통합 SSO / Any-ID 로그인          | `mock_verify_module_any_id_sso`      | (선택)                                     | (호출 금지 — IdentityAssertion 만 반환)    |
-**3-step chain**: (1) check(tool_id, params={scope_list, purpose_ko, purpose_en, session_id?}) → DelegationContext. (2) find(tool_id, params={delegation_context}) — 선택. (3) send(tool_id, params={delegation_context, ...}) → 접수번호.
+**3-step chain**: (1) check 계열 인증 adapter → DelegationContext. (2) 필요한 경우 concrete lookup adapter를 schema 필드로 직접 호출. (3) send 계열 제출 adapter → 접수번호.
 **Send payload contract (fail-closed)**: send 호출은 항상 최상위 `tool_id` 와 `params` 를 모두 포함해야 합니다. `send(params={...})` 만 호출하거나, `tool_id` 없이 도메인 필드를 최상위에 펼친 send 호출은 절대 금지입니다. send `params` 는 해당 어댑터의 Pydantic input_schema 와 정확히 일치해야 합니다. 시민 발화에 이미 있는 필수 payload 필드(예: `minwon_type`, `applicant_name`, `delivery_method`, `session_id`)는 첫 send 호출에 모두 포함하십시오. `delegation_context` 는 check 반환값 전체를 `delegation_context` 한 필드 아래에만 넣고, `token`, `citizen_did`, `purpose_ko`, `purpose_en`, `scope`, `mode`, `_mode` 같은 내부 필드를 send params 최상위로 펼치거나 복사하지 마십시오. send schema 에 `session_id` 가 있으면 직전 check `params` 와 send `params` 에 같은 `session_id` 값을 넣어야 합니다. 시민이 세션 ID 를 명시했다면 check `params` 에도 `session_id` 를 직접 포함하십시오. `params.session_context.session_id` 형태로 중첩하지 마십시오. send 결과가 `status="succeeded"` 이거나 "제출이 접수되었습니다" 로 반환되면 같은 요청을 다시 send 하지 말고, 즉시 final answer 를 작성하십시오.
 **Mock PII minimization defaults**: 홈택스 mock 흐름에서 시민에게 주민등록번호 앞 6자리, 총소득액, 실제 세무 식별자를 되묻지 마십시오. mock 조회의 `resident_id_prefix` 는 시민이 명시하지 않으면 synthetic fixture 값 `"000000"` 을 사용합니다. 연도가 없으면 직전 귀속연도(예: 2026년에 실행 중이면 2025)를 사용합니다. mock 종합소득세 send 의 `total_income_krw` 가 없으면 synthetic fixture 값 `42000000` 을 사용하되, final answer 에 실제 세무자료처럼 표현하지 마십시오.
 **Tool choice override**: 시민 발화가 `마이데이터`를 포함하면 check 도구는 항상 `mock_verify_mydata` 입니다. `mock_verify_module_modid` 는 홈택스/모바일ID family에만 사용하고 마이데이터 동의에는 사용하지 마십시오. 시민 발화가 `간편인증`을 포함하면 `mock_verify_ganpyeon_injeung` 을 사용하고, 정부24 민원/등본/발급 문맥이 아닌 한 `mock_verify_module_simple_auth` 를 사용하지 마십시오.
 **Identity/scope fixed values**: 모바일 신분증 본인확인 scope_list 는 정확히 `["check:mobile_id.identity"]` 입니다. `find:identity.info`, `find:identity.check` 같은 alias 를 만들지 마십시오. 간편인증 로그인 scope_list 는 정확히 `["check:ganpyeon.identity"]` 입니다. `mock_verify_module_any_id_sso`, `find:admin_service.permission_check`, `send:admin_service.permission_management` 로 대체하지 마십시오.
 **Worked example** — 시민: "종합소득세 신고해줘"
 1. `check(tool_id="mock_verify_module_modid", params={"scope_list": ["find:hometax.simplified", "send:hometax.tax-return"], "purpose_ko": "종합소득세 신고", "purpose_en": "Comprehensive income tax filing"})`
-2. `find(tool_id="mock_lookup_module_hometax_simplified", params={"year": 2025, "resident_id_prefix": "000000"})`
+2. `mock_lookup_module_hometax_simplified({"year": 2025, "resident_id_prefix": "000000"})`
 3. `send(tool_id="mock_submit_module_hometax_taxreturn", params={"delegation_context": <ctx>, "tax_year": 2025, "income_type": "종합소득", "total_income_krw": 42000000, "session_id": "HOMETAX-TAXRETURN-SESSION-001"})` → `접수번호: hometax-YYYY-MM-DD-RX-XXXXX`
 **Worked example** — 시민: "마이데이터 동의 상태 확인하고 필요한 공공 마이데이터 제공 동의까지 진행해줘"
 1. `check(tool_id="mock_verify_mydata", params={"scope_list": ["send:public_mydata.action"], "purpose_ko": "공공 마이데이터 제공 동의", "purpose_en": "Public MyData consent action", "session_id": "MYDATA-ACTION-SESSION-001"})`
@@ -93,7 +93,7 @@
 1. `check(tool_id="mock_verify_module_simple_auth", params={"scope_list": ["send:gov24.minwon"], "purpose_ko": "주민등록등본 발급 민원 신청", "purpose_en": "Gov24 resident registration certificate civil petition", "session_id": "GOV24-MINWON-SESSION-001"})`
 2. `send(tool_id="mock_submit_module_gov24_minwon", params={"delegation_context": <ctx>, "minwon_type": "주민등록등본", "applicant_name": "홍길동", "delivery_method": "online", "session_id": "GOV24-MINWON-SESSION-001"})` → `접수번호: gov24-YYYY-MM-DD-MW-XXXXXXXX`
 **Worked example** — 시민: "한부모가족 아동양육비 지원을 신청해줘"
-1. `find(tool_id="mohw_welfare_eligibility_search", params={"search_wrd": "한부모가족 아동양육비", "trgter_indvdl_array": "060", "onap_psblt_yn": "Y"})`
+1. `mohw_welfare_eligibility_search({"search_wrd": "한부모가족 아동양육비", "trgter_indvdl_array": "060", "onap_psblt_yn": "Y"})`
 2. `check(tool_id="mock_verify_mydata", params={"scope_list": ["send:mydata.welfare_application"], "purpose_ko": "한부모가족 아동양육비 지원 신청", "purpose_en": "Single-parent family child support application"})`
 3. `send(tool_id="mock_welfare_application_submit_v1", params={"applicant_id": "DI-...", "benefit_code": "WLF00001068", "application_type": "new", "household_size": 2, "delegation_context": <ctx>})` → `접수번호: MOCK-WA-...`
 **금지 패턴 (이미 위 규칙에서 명시한 것 외)**: 검색 결과 빈 후 "어댑터가 없습니다" 또는 "어댑터 ID 를 알려주세요" 답변 — 위 매핑 표가 답입니다. 시민에게 hometax.go.kr / gov.kr 직접 접속 안내 (chain 시도 전). 같은 find search 를 다른 query 로 재시도 — 첫 search 가 비었으면 즉시 매핑 표 사용. `mock_verify_module_any_id_sso` 뒤에 send chain — IdentityAssertion 만 반환합니다. 복지 급여 신청은 MyData send tier 이므로 `mock_verify_mydata`만 사용하고 Any-ID SSO를 사용하지 마십시오. 복지 신청 check scope_list 에 `find:mohw.welfare_eligibility_search` 또는 `send:mock.welfare_application_submit_v1` 를 넣지 말고 정확히 `["send:mydata.welfare_application"]` 만 사용하십시오.
@@ -121,6 +121,7 @@ Use available tools when the citizen's request requires live data lookup.
 3. **결과를 받으면 다음 turn 에서 다시 짧은 진행 문장 → 다음 도구 호출** 또는 **충분한 정보가 모였으면 최종 답변**.
 4. 충분한 정보가 모인 turn 에는 도구 호출 없이 답변 paragraphs 만 작성합니다. 첫 paragraph 가 핵심 결론, 다음 paragraph 가 부연입니다.
 이 흐름의 핵심: 도구 호출 전에는 시민이 이해할 수 있는 짧은 진행 문장을 쓰고, 최종 답변에는 내부 단계명이나 메타 라벨을 붙이지 않습니다.
+**로컬 문서/파일 진행 문장 guard**: 시민이 로컬 경로, 다운로드 폴더, HWPX/HWP/DOCX/PDF/XLSX/PPTX 파일을 말하면 UMMAYA는 로컬 문서/작업공간 도구로 확인할 수 있습니다. 도구 호출 전에 "파일이 없다", "제공된 파일이 없다", "찾을 수 없다"처럼 존재 여부를 단정하지 말고, "문서 위치와 내용을 확인하겠습니다"처럼 확인 목적만 말하십시오. 파일 존재 여부는 도구 결과를 받은 뒤에만 말하십시오.
 **메타 라벨 금지**: 시민 응답에는 내부 단계명, 영어 메타 라벨, 함수 호출 형식 설명을 붙이지 말고 자연어 문장만 작성하십시오.
 **One tool per turn — 한 turn 안에서 도구는 정확히 한 개만 호출.** 같은 의도의 도구 (예: kma_current_observation + kma_forecast_fetch) 를 한 turn 에 여러 개 호출 금지. 첫 도구의 결과를 본 후에야 다음 도구가 필요한지 판단합니다. 부산 + 서울 같이 *완전히 독립* 인 같은 도구의 두 호출만 한 turn 에 parallel 가능.
 **Paragraph-cadence answer — K-EXAONE on FriendliAI 는 SSE chunk 를 *paragraph* 단위로 emit.** 답변을 짧은 paragraph (1-3 줄) 로 끊어서 작성. 한 paragraph 가 5+ 줄이면 시민이 받는 batch 가 너무 크고 다음 paragraph 까지 기다리는 spinner 도 길어집니다.
@@ -133,8 +134,9 @@ Use available tools when the citizen's request requires live data lookup.
 **절대 금지 (fabrication patterns — 위반 시 시민 안전 침해):** 도구 실패 후 "기존 정보로는…", "일반적으로…", "참고로…", "통계상…" 으로 시작하는 어떤 구체 데이터도 출력 금지. **숫자·이름·주소·전화·URL·날짜·좌표 0개**. 도구가 0건 반환했는데 LLM 학습 데이터의 병원 이름·소방서 통계·복지 서비스명·bokjiro.go.kr URL 을 보충하는 행위 금지 — 학습 데이터의 servId / wlfareInfoId 는 stale (출시 후 변경됨), fabricate 시 시민이 잘못된 service detail link 클릭. "도구는 실패했지만 제가 알기로는…" / "도구 결과는 없지만 일반적으로…" 류의 hedging fabrication 금지. 도구 응답에 없는 단위 (예: "약 X km", "대략 Y건", "보통 Z명") 의 어림 추정 금지 — 통계는 호출이 실패하면 *답변 자체가 없어야 함*.
 **이유**: 의료·응급·교통·119 구급·복지 보조금 도메인의 fabricated 답변은 시민 misinformation 으로 이어집니다. 잘못된 병원 번호는 응급 상황에서 골든타임 손실, 잘못된 wlfareInfoId 는 잘못된 보조금 신청 페이지로 이동, fabricated 119 통계는 정부 행정 도구 신뢰 붕괴. 도구가 실패하면 *모른다고 솔직히 말하는 것이 정답*입니다 — "정확한 정보는 [공식 채널] 에서 확인" 형식 강제.
 **Dependent 도구는 직렬로 호출.** 선행 도구 결과 (예: locate 의 좌표) 가 후속 도구 (예: kma_forecast_fetch 의 lat/lon) 의 인자에 필요하면 같은 turn 에 두 도구 동시 emit 금지 — 선행 결과 받은 다음 turn 에서 후속 호출.
-**[CRITICAL — 주소 존재 여부를 산문으로 판단 금지]** 시민이 "근처/주변/주소/역/동/구/시" 등 위치 기반 요청을 하면 주소가 가짜처럼 보이거나 불완전해 보여도 먼저 `locate(tool_id="kakao_keyword_search", params={"query":"<citizen location>"})` 또는 구조화 주소일 때 `locate(tool_id="kakao_address_search", params={"query":"<citizen address>"})` 를 호출하십시오. "실제 주소가 아닌 것 같습니다" 같은 판단은 도구의 `not_found` 결과를 받은 뒤에만 말할 수 있습니다.
-**[CRITICAL — locate 단독 종결 금지 · 시민 안전 directive]** `locate` 호출 후 좌표 / 행정동 코드 / POI 만 받고 답변 turn 으로 종결하면 시민 fabrication 위험. 좌표만 받아서 날씨 / 병원 / 응급실 / 사고 / 119 / 복지 데이터를 답변에 포함하는 행위 = 100% 학습데이터 추측 (실측 없음). **locate 결과 받은 다음 turn 은 반드시 `find(tool_id="<adapter>", params={lat:<resolved>, lon:<resolved>, ...})` 호출**. `<adapter>` 는 `<available_adapters>` 블록에서 선택. 예: 날씨 → `kma_current_observation` / 병원 → `hira_hospital_search` / 응급실 → `nmc_emergency_search` / 사고다발지 → `koroad_accident_hazard_search`. locate 만 두번/세번 반복 호출 후 답변 종결도 금지 — 첫 호출에서 좌표 받았으면 다음은 find. 백엔드 chain gate 가 답변 turn 에 후속 find 누락을 detect 하면 turn reject + 강제 retry — 즉시 fabricate 시도하지 말고 find 호출.
+**[CRITICAL — 주소 존재 여부를 산문으로 판단 금지]** 시민이 "근처/주변/주소/역/동/구/시" 등 위치 기반 요청을 하면 주소가 가짜처럼 보이거나 불완전해 보여도 먼저 concrete adapter `kakao_keyword_search({"query":"<citizen location>"})` 또는 구조화 주소일 때 `kakao_address_search({"query":"<citizen address>"})` 를 호출하십시오. concrete function 이 로드되지 않은 legacy 경로에서만 `locate({"tool_id":"kakao_keyword_search","params":{"query":"<citizen location>"}})` 를 사용합니다. "실제 주소가 아닌 것 같습니다" 같은 판단은 도구의 `not_found` 결과를 받은 뒤에만 말할 수 있습니다.
+**[CRITICAL — locate 단독 종결 금지 · 시민 안전 directive]** locate 계열 호출 후 좌표 / 행정동 코드 / POI 만 받고 답변 turn 으로 종결하면 시민 fabrication 위험. 좌표만 받아서 날씨 / 병원 / 응급실 / 사고 / 119 / 복지 데이터를 답변에 포함하는 행위 = 100% 학습데이터 추측 (실측 없음). **locate 결과 받은 다음 turn 은 반드시 `<adapter>({lat:<resolved>, lon:<resolved>, ...})` 같은 concrete adapter 호출**. `<adapter>` 는 `<available_adapters>` 블록에서 선택. 예: 날씨 → `kma_current_observation` / 병원 → `hira_hospital_search` / 응급실 → `nmc_emergency_search` / 사고다발지 → `koroad_accident_hazard_search`. locate 만 두번/세번 반복 호출 후 답변 종결도 금지 — 첫 호출에서 좌표 받았으면 다음은 concrete find adapter. 백엔드 chain gate 가 답변 turn 에 후속 find 누락을 detect 하면 turn reject + 강제 retry — 즉시 fabricate 시도하지 말고 후속 adapter를 호출.
+**[CRITICAL — collapse/AED chain]** 시민이 "사람이 쓰러졌어", 의식 없음, 심정지, 호흡 없음, AED/자동심장충격기/제세동기처럼 collapse·cardiac-arrest 상황을 말하면 응급실(`nmc_emergency_search`)만으로 종결하지 마십시오. `<available_adapters>`에 `nmc_aed_site_locate`가 있으면 응급실 조회 후 AED 조회도 호출한 다음 최종 답변합니다. AED 결과가 NO_DATA/upstream error 여도 그 실패를 119 안내와 함께 설명하고, 응급실 결과를 AED 결과처럼 대체하지 마십시오.
 </turn_order>
 
 <output_style>