WebMCP

1. 단언: 이 단계들은 병렬로 실행 중이다.

2. traversable의 대기 중 도구 실행 맵[uuid]이 존재하지 않으면 반환한다.

   참고: 도구의 자연스러운 이행/거부가 호출자의 취소와 어떻게 경쟁할 수 있는지 알아보려면 이 참고를 참조한다. 이 때문에 여기에 도달하기 전에 uuid에 대한 대기 중 실행 항목이 제거될 수 있다. 이 경우에도 executeTool() 프로미스는 여전히 중단 중단 이유로 거부되며, 도구의 자연스러운 이행/거부를 관찰하지 않는다.

3. execution을 traversable의 대기 중 도구 실행 맵[uuid]으로 둔다.

4. traversable의 대기 중 도구 실행 맵[uuid]을 제거한다.

5. targetDocument를 execution의 대상 문서로 둔다.

   참고: 이 단계들이 실행될 때 targetDocument는 여전히 존재함(즉, 언로드되거나 파괴되지 않음)이 보장된다. targetDocument가 파괴되었다면 이 명세의 언로드 문서 정리 단계가 이미 맵에서 execution을 제거했을 것이며, 위의 조기 반환 경로에 들어갔을 것이기 때문이다.

6. targetDocument의 관련 전역 객체가 주어졌을 때 전역 태스크를 대기열에 추가하여 webmcp 태스크 소스에서 다음 단계를 실행한다.

   1. localExecutions를 targetDocument의 연결된 ModelContext의 내부 컨텍스트의 로컬 대기 중 도구 실행 맵으로 둔다.

   2. localExecutions[uuid]이 존재하지 않으면 반환한다.

   3. localExecution을 localExecutions[uuid]으로 둔다.

   4. localExecutions[uuid]을 제거한다.

   5. localExecution의 중단 컨트롤러에 중단 신호를 보낸다.

      targetDocument의 관련 전역 객체에서 "toolcanceled" 이벤트를 발생시킨다. [이슈 #146]

1. traversable을 document의 노드 내비게이블의 순회 가능한 내비게이블로 둔다.

2. 다음 단계를 병렬로 실행한다.

   1. executionsToRemove를 빈 목록으로 둔다.

   2. traversable의 대기 중 도구 실행 맵의 각 uuid → execution에 대해 각각:

      1. document가 execution의 대상 문서이거나 document가 execution의 호출자 문서이면, uuid를 executionsToRemove에 추가한다.

   3. executionsToRemove의 각 uuid에 대해 각각:

      1. execution을 traversable의 대기 중 도구 실행 맵[uuid]으로 둔다.

      2. document가 execution의 대상 문서이고 execution의 호출자 문서는 아닌 경우, null과 false를 주어 execution의 완료 단계를 실행한다.

         참고: 이는 대기 중 도구 실행 맵에서 execution을 제거한다.

      3. 그렇지 않고 document가 execution의 호출자 문서이며 execution의 대상 문서는 아니면, traversable과 uuid가 주어졌을 때 대기 중 도구 실행을 취소한다.

      4. 그렇지 않으면 traversable의 대기 중 도구 실행 맵[uuid]을 제거한다.

      5. 단언: traversable의 대기 중 도구 실행 맵[uuid]은 존재하지 않는다.

1. 단언: 이 단계들은 병렬로 실행 중이다.

2. navigablesToNotify를 tool owner의 노드 내비게이블의 순회 가능한 내비게이블의 포괄 하위 내비게이블로 둔다.

3. navigablesToNotify의 각 navigable에 대해 각각:

   1. targetDocument를 navigable의 활성 문서로 둔다.

   2. targetDocument가 "tools" 기능을 사용하도록 허용되지 않은 경우, 계속한다.

   3. tool owner의 출처, exposed origins, 그리고 targetDocument의 출처가 주어졌을 때 도구가 출처에 노출되는지가 true이면, targetDocument의 관련 전역 객체가 주어졌을 때 전역 태스크를 대기열에 추가하여 webmcp 태스크 소스에서 targetDocument의 연결된 ModelContext에 이름이 toolchange인 이벤트를 발생시킨다.

document.modelContext.ontoolchange = e => console.log('부모 toolchange');
iframe.contentDocument.modelContext.ontoolchange = e => console.log('자식 toolchange');

// `webmcp task source`에서 `toolchange`를 발생시키는 태스크를 대기열에 추가한다.
const p = document.modelContext.registerTool({
  name: "tool_name",
  description: "도구 설명",
  execute: async () => {}
});

p.then(() => console.log('등록 프로미스가 이행됨'));

// `timer task source`에 태스크를 대기열에 추가한다.
setTimeout(() => console.log('등록 후 태스크'));

// `부모 toolchange`는 항상 `자식 toolchange`보다 먼저 기록되고,
// `등록 프로미스가 이행됨`은 항상 둘 다 이후에 기록된다.
// 그러나 `등록 후 태스크`는 세 항목 모두의 전, 사이 또는 후에 기록될 수 있다.

1. tool owner origin이 accessing origin과 동일 출처이면 true를 반환한다.

2. exposed origins의 각 allowed origin에 대해 각각:

   1. accessing origin이 allowed origin과 동일 출처이면 true를 반환한다.

3. false를 반환한다.

1. 단언: 이 단계들은 targetDocument의 관련 에이전트의 이벤트 루프에서 실행 중이다.

2. toolMap을 targetDocument의 연결된 ModelContext의 내부 컨텍스트의 도구 맵으로 둔다.

3. toolMap[toolName]이 존재하지 않으면 null과 false를 주어 completionSteps를 실행하고 이 단계를 중단한다.

   호출자에게 더 세분화된 오류를 되돌려 보내는 연결 처리를 지원한다. 호출 문서에서는 이것이 "NotFoundError"를 발생시켜야 한다.

   이는 도구 등록 해제와 실행 사이의 경쟁으로부터 보호한다. 도구 존재 여부는 이 경쟁으로부터 보호되지만, 도구 등록을 해제한 직후 동일한 toolName이지만 입력 스키마가 다른 도구를 빠르게 다시 등록하는 경우는 보호되지 않는다.

   그 결과 이전 도구의 inputArguments가 새 도구의 입력 스키마에 적용되어 이슈 #92가 해결될 때 발생할 수 있는 어떤 오류든 유발할 수 있다.

   // -- 도구 소유자 문서. --
   const oldInputSchema = {...};
   const newInputSchema = {...};
   const ac = new AbortController();
   document.modelContext.registerTool({..., inputSchema: oldInputSchema}, {signal: ac.signal});
   
   // 등록을 해제한 뒤 업데이트된 입력 스키마로 빠르게 다시 등록한다.
   ac.abort();
   document.modelContext.registerTool({..., inputSchema: newInputSchema});
   
   
   // -- 실행 문서. --
   //
   // 이는 위의 "이전" 도구 또는 "새" 도구 중 어느 쪽이든 대상으로 할 수 있으며,
   // 실행은 불일치 때문에 필요한 오류를 만날 수 있다.
   const [tool] = await document.modelContext.getTools();
   document.modelContext.executeTool(tool, {a: 10});
   

4. tool을 toolMap[toolName]으로 둔다.

5. targetDocument, inputArguments, completionSteps, 그리고 uuid가 주어졌을 때 tool의 실행 단계를 실행한다.

   참고: 여기에서 명령형 실행 단계 또는 선언적 실행 단계 중 하나로 분기한다.

1. 단언: 이 단계들은 targetDocument의 관련 에이전트의 이벤트 루프에서 실행 중이다.

2. inputObject를 inputArguments와 targetDocument의 관련 영역이 주어졌을 때 JSON 문자열을 JavaScript 값으로 파싱한 결과로 둔다. 예외가 발생했다면 null과 false를 주어 completionSteps를 실행하고 이 단계를 중단한다.

   더 세분화된 오류를 지원한다. 여기서는 호출자가 자신의 Promise를 "DataError" DOMException으로 거부하도록 하는 무언가를 반환해야 한다.

3. inputObject가 Object가 아님이 false이면 null과 false를 주어 completionSteps를 실행하고 이 단계를 중단한다.

   "toolactivated" 이벤트를 명세하고 발생시킨다. [이슈 #146]

4. controller를 targetDocument의 관련 영역에서 생성된 새 AbortController로 둔다.

5. localExecution을 다음 항목을 갖는 새 로컬 대기 중 도구 실행으로 둔다.

   중단 컨트롤러

   controller

6. targetDocument의 연결된 ModelContext의 내부 컨텍스트의 로컬 대기 중 도구 실행 맵[uuid]을 localExecution으로 설정한다.

7. options를 다음 필드를 갖는 새 ToolExecuteCallbackOptions 딕셔너리로 둔다.

   signal

   controller의 signal

8. toolPromise를 tool의 execute를 inputObject와 options를 사용하여 호출한 결과로 둔다.

9. toolPromise에 반응한다.

   • toolPromise가 값 v로 이행된 경우:

     1. localExecutions을 targetDocument의 연결된 ModelContext의 내부 컨텍스트의 로컬 대기 중 도구 실행 맵으로 둔다.

     2. localExecutions[uuid]이 존재하지 않으면 반환한다.

        참고: 개발자의 toolPromise가 결정되기 전에 실행이 취소되었다면(따라서 해당 항목도 제거되었다면) uuid에 대응하는 항목은 존재하지 않는다.

     3. localExecutions[uuid]을 제거한다.

     4. serializedResult를 v가 주어졌을 때 JavaScript 값을 JSON 문자열로 직렬화한 결과로 둔다. 예외가 발생하면 null과 false를 주어 completionSteps를 실행하고 이 단계를 중단한다.

     5. serializedResult와 true를 주어 completionSteps를 실행한다.

   • toolPromise가 이유 r로 거부된 경우:

     1. 선택적으로 r을 설명하는 경고를 콘솔에 보고한다.

     2. localExecutions을 targetDocument의 연결된 ModelContext의 내부 컨텍스트의 로컬 대기 중 도구 실행 맵으로 둔다.

     3. localExecutions[uuid]이 존재하지 않으면 반환한다.

     4. localExecutions[uuid]을 제거한다.

     5. null과 false를 주어 completionSteps를 실행한다.

1. 단언: 이 단계들은 modelContext의 관련 에이전트의 이벤트 루프에서 실행 중이다.

2. tool map을 modelContext의 내부 컨텍스트의 도구 맵으로 둔다.

3. tool map[tool name]이 존재하지 않으면 반환한다.

4. exposed origins를 tool map[tool name]의 노출된 출처로 둔다.

5. tool map[tool name]을 제거한다.

6. targetDocument를 modelContext의 관련 전역 객체의 연결된 Document로 둔다.

7. 병렬로, targetDocument와 exposed origins가 주어졌을 때 도구 변경을 문서에 알린다.

1. this의 연결된 ModelContext 객체를 반환한다.

1. global을 this의 관련 전역 객체로 둔다.

2. tool owner를 global의 연결된 Document로 둔다.

3. tool owner가 완전히 활성 상태가 아니면 "InvalidStateError" DOMException으로 거부된 프로미스를 반환한다.

4. this의 주변 에이전트의 에이전트 클러스터의 출처 키 기반 여부가 false이고 this의 관련 설정 객체의 출처의 스킴이 "file"이 아니면, "SecurityError" DOMException으로 거부된 프로미스를 반환한다.

5. tool owner가 "tools" 기능을 사용하도록 허용되지 않은 경우, "NotAllowedError" DOMException으로 거부된 프로미스를 반환한다.

6. tool map을 this의 내부 컨텍스트의 도구 맵으로 둔다.

7. tool name을 tool의 name으로 둔다.

8. tool title을 tool의 title로 둔다.

9. tool map[tool name]이 존재하면 InvalidStateError DOMException으로 거부된 프로미스를 반환한다.

10. tool name 또는 description이 빈 문자열이면 InvalidStateError DOMException으로 거부된 프로미스를 반환한다.

11. tool name이 빈 문자열이거나, 그 길이가 128보다 크거나, tool name에 ASCII 영숫자, U+005F (_), U+002D (-), U+002E (.)가 아닌 코드 포인트가 포함되어 있으면 InvalidStateError DOMException으로 거부된 프로미스를 반환한다.

12. stringified input schema를 빈 문자열로 둔다.

13. tool의 inputSchema가 존재하면 stringified input schema를 tool의 inputSchema가 주어졌을 때 JavaScript 값을 JSON 문자열로 직렬화한 결과로 설정한다. 이 과정에서 예외가 발생하면 해당 예외로 거부된 프로미스를 반환한다.

    위 직렬화 알고리즘은 다음 경우에 예외를 발생시킨다.

    1. 기반 "JSON.stringify()"가 undefined를 생성하는 경우, 예를 들어 "inputSchema: { toJSON() {return HTMLDivElement;}}" 또는 "inputSchema: { toJSON() {return undefined;}}"인 경우 새 TypeError를 발생시킨다.

    2. 예를 들어 "inputSchema"가 순환 참조를 갖는 객체인 경우처럼 "JSON.stringify()"가 발생시킨 예외를 다시 발생시킨다.

14. options의 signal이 존재하고 중단됨 상태이면 options의 signal의 중단 이유로 거부된 프로미스를 반환한다.

15. exposed origins를 빈 목록인 출처로 둔다.

16. options의 exposedTo가 존재하면:

    1. options의 exposedTo의 각 origin에 대해 각각:

       1. parsedURL을 origin에 URL 파서를 실행한 결과로 둔다.

       2. parsedURL이 실패이거나 그 출처가 잠재적으로 신뢰할 수 있는 것이 아니면 "SecurityError" DOMException으로 거부된 프로미스를 반환한다.

       3. parsedURL의 출처를 exposed origins에 추가한다.

17. promise를 this의 관련 영역에서 생성된 새 프로미스로 둔다.

18. options의 signal이 존재하면:

    1. signal을 options의 signal로 둔다.

    2. signal이 중단됨 상태이면 signal의 중단 이유로 거부된 프로미스를 반환한다.

    3. 다음 중단 단계를 추가하여 signal에 등록한다.

       1. this와 tool name이 주어졌을 때 도구 등록을 해제한다.

       2. promise를 signal의 중단 이유로 거부한다.

19. tool definition을 다음 항목을 갖는 새 도구 정의로 둔다.

    이름

    tool name

    제목

    tool title

    설명

    tool의 description

    입력 스키마

    stringified input schema

    실행 단계

    Document targetDocument, 문자열 inputArguments, 알고리즘 completionSteps, 그리고 고유 내부 값 uuid를 받고, tool, targetDocument, inputArguments, completionSteps, 그리고 uuid가 주어졌을 때 명령형 실행 단계를 실행하는 알고리즘이다.

    주석

    tool의 annotations이 존재하지 않으면 null이다. 그렇지 않으면 다음 항목을 갖는 주석이다.

    읽기 전용 힌트

    tool의 annotations의 readOnlyHint

    신뢰할 수 없는 콘텐츠 힌트

    tool의 annotations의 untrustedContentHint

    노출된 출처

    exposed origins

20. this의 내부 컨텍스트의 도구 맵[tool name]을 tool definition으로 설정한다.

21. 다음 단계를 병렬로 실행한다.

    1. tool owner와 exposed origins가 주어졌을 때 도구 변경을 문서에 알린다.

    2. global이 주어졌을 때 전역 태스크를 대기열에 추가하여 webmcp 태스크 소스에서 promise를 undefined로 이행한다.

22. promise를 반환한다

1. global을 this의 관련 전역 객체로 둔다.

2. toolRequestor를 global의 연결된 Document로 둔다.

3. toolRequestor가 완전히 활성 상태가 아니면 "InvalidStateError" DOMException으로 거부된 프로미스를 반환한다.

4. this의 주변 에이전트의 에이전트 클러스터의 출처 키 기반 여부가 false이고 this의 관련 설정 객체의 출처의 스킴이 "file"이 아니면 "SecurityError" DOMException으로 거부된 프로미스를 반환한다.

5. toolRequestor가 "tools" 기능을 사용하도록 허용되지 않은 경우, "NotAllowedError" DOMException으로 거부된 프로미스를 반환한다.

6. from origins를 빈 목록인 출처로 둔다.

7. options의 fromOrigins가 존재하면:

   1. options의 fromOrigins의 각 origin에 대해 각각:

      1. parsedURL을 origin에 URL 파서를 실행한 결과로 둔다.

      2. parsedURL이 실패이거나 그 출처가 잠재적으로 신뢰할 수 있는 것이 아니면 "SecurityError" DOMException으로 거부된 프로미스를 반환한다.

      3. parsedURL의 출처를 from origins에 추가한다.

8. promise를 this의 관련 영역에서 생성된 새 프로미스로 둔다.

9. 다음 단계를 병렬로 실행한다.

   1. tools를 빈 목록인 RegisteredTool 딕셔너리로 둔다.

   2. navigables를 toolRequestor의 노드 내비게이블의 순회 가능한 내비게이블의 포괄 하위 내비게이블로 둔다.

   3. navigables의 각 navigable에 대해 각각:

      1. targetDocument를 navigable의 활성 문서로 둔다.

      2. targetDocument가 "tools" 기능을 사용하도록 허용되지 않은 경우, 계속한다.

      3. targetOrigin을 targetDocument의 출처로 둔다.

      4. callerOrigin을 toolRequestor의 출처로 둔다.

      5. targetOrigin이 callerOrigin과 동일 출처이거나, from origins가 targetOrigin을 포함하면 toolOwnerIsRequested를 true로 둔다. 그렇지 않으면 false로 둔다.

      6. toolOwnerIsRequested가 false이면 계속한다.

      7. targetToolMap을 targetDocument의 연결된 ModelContext의 내부 컨텍스트의 도구 맵으로 둔다.

      8. targetToolMap의 각 tool name → tool definition에 대해 각각:

         1. targetOrigin, tool definition의 노출된 출처, 그리고 callerOrigin이 주어졌을 때 도구가 출처에 노출되는지가 false를 반환하면 계속한다.

         2. registeredTool을 다음 필드를 갖는 새 RegisteredTool 딕셔너리로 둔다.

            name

            tool definition의 이름

            title

            tool definition의 제목이 null이 아니면 해당 값, 그렇지 않으면 빈 문자열.

            빈 문자열을 기본값으로 하지 않고 이 멤버를 제외하여 undefined가 되도록 하는 것을 고려한다. [이슈 #224]

            description

            tool definition의 설명

            inputSchema

            tool definition의 입력 스키마가 빈 문자열이 아니면, tool definition의 입력 스키마가 주어졌을 때 JSON 문자열을 JavaScript 값으로 파싱한 결과이고, 그렇지 않으면 undefined이다.

            참고: 도구 정의에 저장된 문자열은 항상 유효한 JSON 문자열이므로 이는 절대로 예외를 발생시키지 않는다.

            window

            targetDocument의 관련 전역 객체

            origin

            직렬화된 targetOrigin.

            annotations

            tool definition의 주석이 null이 아니면, ToolAnnotations 딕셔너리이며, 그 readOnlyHint는 tool definition의 주석의 읽기 전용 힌트이고, untrustedContentHint는 tool definition의 주석의 신뢰할 수 없는 콘텐츠 힌트이다.

         3. registeredTool을 tools에 추가한다.

   4. a["name"]이 b["name"]보다 코드 단위 기준으로 작으면 a가 b보다 작은 것으로 하여 tools를 오름차순으로 정렬한다.

   5. global이 주어졌을 때 전역 태스크를 대기열에 추가하여 webmcp 태스크 소스에서 promise를 tools로 이행한다.

10. promise를 반환한다.

1. callerDocument를 this의 관련 전역 객체의 연결된 Document로 둔다.

2. callerDocument가 완전히 활성 상태가 아니면 "InvalidStateError" DOMException으로 거부된 프로미스를 반환한다.

3. this의 주변 에이전트의 에이전트 클러스터의 출처 키 기반 여부가 false이고 this의 관련 설정 객체의 출처의 스킴이 "file"이 아니면 "SecurityError" DOMException으로 거부된 프로미스를 반환한다.

4. callerDocument가 "tools" 기능을 사용하도록 허용되지 않은 경우, "NotAllowedError" DOMException으로 거부된 프로미스를 반환한다.

5. expectedTargetOriginURL을 tool의 origin을 파싱한 결과로 둔다.

6. expectedTargetOriginURL이 실패이거나 expectedTargetOriginURL의 출처가 불투명 출처이면 "NotSupportedError" DOMException으로 거부된 프로미스를 반환한다.

7. expectedTargetOrigin을 expectedTargetOriginURL의 출처로 둔다.

8. 단언: expectedTargetOrigin은 불투명 출처가 아니다.

9. inputArguments를 inputObject가 주어졌을 때 JavaScript 값을 JSON 문자열로 직렬화한 결과로 둔다. 예외가 발생하면 해당 예외로 거부된 프로미스를 반환한다.

10. promise를 this의 관련 영역에서 생성된 새 프로미스로 둔다.

11. targetWindow를 tool의 window로 둔다.

12. targetDocument를 targetWindow의 연결된 Document로 둔다.

13. uuid를 새 고유 내부 값으로 둔다.

14. options의 signal이 존재하면:

    1. signal을 options의 signal로 둔다.

    2. signal이 중단됨 상태이면 signal의 중단 이유로 거부된 프로미스를 반환한다.

    3. traversable을 targetDocument의 노드 내비게이블의 순회 가능한 내비게이블로 둔다.

    4. 다음 중단 단계를 추가하여 signal에 등록한다.

       1. promise를 signal의 중단 이유로 거부한다.

       2. 병렬로, traversable과 uuid가 주어졌을 때 대기 중 도구 실행을 취소한다.

15. 다음 단계를 병렬로 실행한다.

    1. targetDocument의 노드 내비게이블의 순회 가능한 내비게이블이 callerDocument의 노드 내비게이블의 순회 가능한 내비게이블과 다르면, callerDocument의 관련 전역 객체가 주어졌을 때 전역 태스크를 대기열에 추가하여 webmcp 태스크 소스에서 promise를 "UnknownError" DOMException으로 거부하고 이 단계를 중단한다.

       동일한 브라우징 컨텍스트 그룹에 있는 최상위 문서 간 도구 실행 지원을 고려한다. [이슈 #227]

       각 실패 사례에 따라 "UnknownError"보다 더 세분화된 오류를 지원한다.

    2. targetOrigin을 targetDocument의 출처로 둔다.

    3. callerOrigin을 callerDocument의 출처로 둔다.

    4. targetOrigin이 expectedTargetOrigin과 동일 출처가 아니면 callerDocument의 관련 전역 객체가 주어졌을 때 전역 태스크를 대기열에 추가하여 webmcp 태스크 소스에서 promise를 "UnknownError" DOMException으로 거부하고 이 단계를 중단한다.

       각 실패 사례에 따라 "UnknownError"보다 더 세분화된 오류를 지원한다.

    5. targetToolMap을 targetDocument의 연결된 ModelContext의 내부 컨텍스트의 도구 맵으로 둔다.

    6. toolName을 tool의 name으로 둔다.

    7. targetToolMap[toolName]이 존재하지 않으면 callerDocument의 관련 전역 객체가 주어졌을 때 전역 태스크를 대기열에 추가하여 webmcp 태스크 소스에서 promise를 "UnknownError" DOMException으로 거부하고 이 단계를 중단한다.

       각 실패 사례에 따라 "UnknownError"보다 더 세분화된 오류를 지원한다.

    8. tool definition을 targetToolMap[toolName]으로 둔다.

    9. targetOrigin, tool definition의 노출된 출처, 그리고 callerOrigin이 주어졌을 때 도구가 출처에 노출되는지가 false를 반환하면 callerDocument의 관련 전역 객체가 주어졌을 때 전역 태스크를 대기열에 추가 하여 webmcp 태스크 소스에서 promise를 "UnknownError" DOMException으로 거부하고 이 단계를 중단한다.

       각 실패 사례에 따라 "UnknownError"보다 더 세분화된 오류를 지원한다.

    10. completionSteps를 문자열-또는-null result와 불리언 success를 받고 다음 단계를 실행하는 알고리즘으로 둔다.

        1. 단언: 이 단계들은 병렬로 실행 중이다.

        2. targetDocument의 노드 내비게이블의 순회 가능한 내비게이블의 대기 중 도구 실행 맵[uuid]이 존재하지 않으면 반환한다.

           uuid로 식별되는 대기 중 실행이 더 이상 존재하지 않을 수 있다. 이는 (a) 호출자 문서가 파괴되거나 호출자가 옵션 signal을 통해 실행을 중단할 때 도구가 취소되는 것과, (b) 도구 프로미스가 이행되는 것 사이의 경쟁 때문에 발생할 수 있다. 둘 다 completionSteps를 호출하기 위해 경쟁하며, 첫 번째 호출은 키 uuid를 사용해 대기 중 실행을 제거한다. 이 검사는 이후의 경쟁 호출을 보호한다.

        3. targetDocument의 노드 내비게이블의 순회 가능한 내비게이블의 대기 중 도구 실행 맵[uuid]을 제거한다.

        4. success가 true이면 callerDocument의 관련 전역 객체가 주어졌을 때 전역 태스크를 대기열에 추가하여 webmcp 태스크 소스에서 promise를 result로 이행한다.

        5. 그렇지 않으면 callerDocument의 관련 전역 객체가 주어졌을 때 전역 태스크를 대기열에 추가하여 webmcp 태스크 소스에서 promise를 "UnknownError" DOMException으로 거부한다.

    11. execution을 다음 항목을 갖는 새 대기 중 도구 실행으로 둔다.

        호출자 문서

        callerDocument

        대상 문서

        targetDocument

        도구 이름

        toolName

        완료 단계

        completionSteps

    12. targetDocument의 노드 내비게이블의 순회 가능한 내비게이블의 대기 중 도구 실행 맵[uuid]을 execution으로 설정한다.

    13. targetWindow가 주어졌을 때 전역 태스크를 대기열에 추가하여 webmcp 태스크 소스에서 toolName, targetDocument, inputArguments, completionSteps, 그리고 uuid가 주어졌을 때 도구 실행 단계를 실행한다.

        참고: 문서는 완전히 활성 상태일 때만 이벤트 루프에서 태스크를 처리하므로, targetDocument가 완전히 활성 상태가 아니면 이는 단순히 도구를 실행하는 단계를 대기열에 추가하고, 문서가 마침내 다시 활성 상태가 되었을 때(즉, bf-cache에서 벗어날 때) 실행한다.

16. promise를 반환한다.

1. TODO: form 및 그 폼 연관 요소에서 적합한 JSON Schema 객체를 도출한다.

선언적 실행 단계와 폼 요소와의 통합을 명세한다.

1. 단언: 이 알고리즘은 브라우저 에이전트의 AI 에이전트 대기열에서 실행 중이다.

2. 단언: traversable의 활성 문서는 완전히 활성 상태이다.

3. observation을 새 관찰로 둔다.

4. flat descendants를 traversable의 활성 문서의 포괄 하위 내비게이블로 둔다.

5. flat descendants의 각 내비게이블 descendant에 대해 각각:

   1. document를 descendant의 활성 문서로 둔다.

   2. id를 document의 고유 ID로 둔다.

   3. observation의 도구 맵[id] = document의 연결된 ModelContext의 내부 컨텍스트의 도구 맵의 값으로 설정한다. 이 값들은 도구 정의이다.

6. 단순히 도구 맵을 채우는 것 이외에도, 사용자 에이전트가 유용하거나 필요하다고 판단하는 내용을 observation에 추가하기 위한 구현 정의 단계를 수행한다. 여기에는 페이지의 주석이 달린 스크린샷, 접근성 트리의 일부 등이 포함될 수 있다.

7. observation과 브라우저 에이전트를 사용하여 observation의 도구 맵을 브라우저 에이전트가 받아들이는 어떤 방식으로든 노출하기 위한 구현 정의 단계를 수행한다.

   참고: 이 API의 이름(WebMCP)에도 불구하고, 이 명세는 도구가 브라우저 에이전트에 노출되는 형식을 규정하지 않는다. 브라우저는 Model Context Protocol, 독점적인 다른 "함수 호출" 방식 또는 적절하다고 판단하는 그 밖의 어떤 방식으로도 도구를 정제하고 노출할 수 있다.

   구현은 기반 모델이 관여하는 여러 당사자를 파악하고 최종 사용자의 의도를 가장 안전하게 수행할 수 있도록, 출처 출처 등을 포함하여 도구 정의와 관련된 모든 관련 보안 정보를 브라우저 에이전트에 전달할 것으로 예상된다.