@ait-co/devtools 0.1.143 → 0.1.144

package/dist/unplugin/index.d.ts

@@ -10257,13 +10257,19 @@ interface AitDevtoolsOptions {
    *
    * true이면 진입점에 게이트된 dynamic import를 자동 추가한다:
    * `?debug=1` + `relay` URL 파라미터가 모두 존재할 때만 런타임에
-   * `@ait-co/devtools/in-app`을 로드하고 `maybeAttach()`를 호출한다.
+   * `@ait-co/debug-console`을 로드하고 `maybeAttach()`를 호출한다.
    *
    * gate가 통과하지 못하면 chunk 자체를 로드하지 않으므로 일반 production
    * 로드에서 dormant하고, 번들러의 DCE 대상이 된다.
    *
+   * `@ait-co/debug-console`은 **optional peer**다 (#817). 설치돼 있지 않으면
+   * 주입 자체를 하지 않으므로 attach 코드가 번들에 구조적으로 들어갈 수 없다 —
+   * 이게 디버그 표면 보안 스코프의 기술적 강제 지점이다. 환경 1(브라우저 mock)만
+   * 쓰는 소비자는 아무것도 추가로 설치하지 않아도 된다.
+   *
    * 소비자가 이미 직접 배선한 경우 중복 주입을 방지하기 위해 파일에
-   * `@ait-co/devtools/in-app`이 이미 있으면 자동으로 스킵한다.
+   * `@ait-co/debug-console`(또는 분리 전 `@ait-co/devtools/in-app`)이 이미 있으면
+   * 자동으로 스킵한다.
    */
   inApp?: boolean;
   /**
@@ -10329,6 +10335,10 @@ interface AitDevtoolsOptions {
      * AI host MCP가 그 relay에 client로 붙으면 실기기 WebKit 위에서 CDP 디버깅이 열린다.
      * mock SDK는 그대로라 `call_sdk`는 환경 2에서 mock을 친다 (fidelity 사다리의
      * 설계 의도 — SDK fidelity가 필요하면 환경 3로 올라간다).
+     *
+     * 이 경로는 **optional peer `@ait-co/debugger`**를 요구한다 (#817).
+     * 미설치면 CDP 배선을 건너뛰고 일반 화면 미리보기 터널로 degrade하며,
+     * 설치 안내를 한 번 출력한다.
      */
     cdp?: boolean;
   };