WebMCP

단언: 이 단계는 병렬로 실행되고 있습니다.

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

참고: 도구의 자연스러운 이행/거부와 호출자의 취소 사이에 경합이 발생할 수 있는 방식은 이 참고 사항을 참조하십시오. 이로 인해 uuid의 대기 중인 실행 항목이 여기까지 도달하기 전에 제거될 수 있습니다. 이 경우 executeTool() 프로미스는 여전히 중단 이유로 거부되며, 도구의 자연스러운 이행/거부를 관찰하지 않습니다.

execution을 traversable의 대기 중인 도구 실행 맵[uuid]으로 둡니다.

traversable의 맵에서 제거합니다. 대상은 대기 중인 도구 실행 맵[uuid]입니다.

targetDocument를 execution의 대상 문서로 둡니다.

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

targetDocument의 관련 전역 객체가 주어졌을 때 webmcp 태스크 소스에 전역 태스크를 큐에 넣어 다음 단계를 실행합니다.

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

2. localExecutions[uuid]가 존재하지 않으면, 반환합니다.

3. localExecution을 localExecutions[uuid]로 둡니다.

4. localExecutions[uuid]를 제거합니다.

5. localExecution의 중단 컨트롤러에 중단을 알립니다.

6. targetDocument의 연결된 ModelContext에서 ToolCancelEvent를 사용하여 toolcancel이라는 이름의 이벤트를 발생시킵니다. 이때 toolName 속성을 execution의 도구 이름으로 초기화합니다.

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

다음 단계를 병렬로 실행합니다.

1. executionsToRemove를 빈 목록으로 둡니다.

2. traversable의 대기 중인 도구 실행 맵의 각 uuid → execution에 대해 반복합니다.

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

3. executionsToRemove의 각 uuid에 대해 반복합니다.

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

   2. document가 execution의 대상 문서이고 execution의 호출자 문서는 아니라면, execution의 완료 단계를 null과 대상 문서 언로드됨을 전달하여 실행합니다.

      참고: 이 과정에서 execution이 대기 중인 도구 실행 맵에서 제거됩니다.

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

   4. 그렇지 않으면 traversable의 항목을 제거합니다. 대상은 대기 중인 도구 실행 맵[uuid]입니다.

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

단언: 이 단계는 병렬로 실행되고 있습니다.

navigablesToNotify를 tool owner의 노드 내비게이블의 순회 가능한 내비게이블의 활성 문서의 자신을 포함한 자손 내비게이블로 둡니다.

navigablesToNotify의 각 navigable에 대해 반복합니다.

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

2. targetDocument가 "tools" 기능을 사용하도록 허용되지 않았다면, 계속합니다.

3. tool owner의 오리진, exposed origins, targetDocument의 오리진이 주어졌을 때 도구가 오리진에 노출된다면, targetDocument의 관련 전역 객체가 주어졌을 때 webmcp 태스크 소스에 전역 태스크를 큐에 넣어 targetDocument의 연결된 ModelContext에서 toolchange라는 이름의 이벤트를 발생시킵니다.

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

exposed origins의 각 allowed origin에 대해 반복합니다.

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

false를 반환합니다.

단언: 이 단계는 targetDocument의 관련 에이전트의 이벤트 루프에서 실행되고 있습니다.

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

toolMap[toolName]이 존재하지 않으면, completionSteps를 null과 도구를 찾을 수 없음을 전달하여 실행하고 이 단계를 중단합니다.

// -- 도구 소유자 문서. --
const oldInputSchema = {...};
const newInputSchema = {...};
const ac = new AbortController();
document.modelContext.registerTool({..., inputSchema: oldInputSchema}, {signal: ac.signal});

// 등록을 해제하고 갱신된 입력 스키마로 빠르게 다시 등록합니다.
ac.abort();
document.modelContext.registerTool({..., inputSchema: newInputSchema});


// -- 실행하는 문서. --
//
// 이는 위의 "old" 도구 또는 "new" 도구 중 어느 쪽을 대상으로 할 수도 있으며,
// 실행 중 불일치로 인해 필요한 오류가 발생할 수 있습니다.
const [tool] = await document.modelContext.getTools();
document.modelContext.executeTool(tool, {a: 10});

tool을 toolMap[toolName]으로 둡니다.

tool의 실행 단계를 targetDocument, inputArguments, completionSteps, uuid를 전달하여 실행합니다.

단언: 이 단계는 targetDocument의 관련 에이전트의 이벤트 루프에서 실행되고 있습니다.

inputObject를 inputArguments가 주어졌을 때 JSON 문자열을 JavaScript 값으로 구문 분석한 결과로 둡니다. 예외가 발생했다면, completionSteps를 null과 잘못된 입력을 전달하여 실행하고 이 단계를 중단합니다.

inputObject가 객체가 아니라면, completionSteps를 null과 잘못된 입력을 전달하여 실행하고 이 단계를 중단합니다.

targetDocument의 연결된 ModelContext에서 ToolActivatedEvent를 사용하여 toolactivated라는 이름의 이벤트를 발생시킵니다. 이때 toolName 속성을 tool의 name으로 초기화합니다.

controller를 targetDocument의 관련 렐름에서 생성된 새 AbortController로 둡니다.

localExecution을 다음 항목을 가진 새로운 로컬 대기 중인 도구 실행으로 둡니다.

중단 컨트롤러

controller

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

options를 다음 필드를 가진 새 ToolExecuteCallbackOptions 딕셔너리로 둡니다.

signal

controller의 신호

toolPromise를 inputObject와 options를 전달하여 tool의 execute를 호출한 결과로 둡니다.

toolPromise에 반응합니다.

• toolPromise가 값 v로 이행되었다면 다음과 같이 합니다.

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

  2. localExecutions[uuid]가 존재하지 않으면 반환합니다.

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

  3. localExecutions[uuid]를 제거합니다.

  4. serializedResult를 v가 주어졌을 때 JavaScript 값을 JSON 문자열로 직렬화한 결과로 둡니다. 이 과정에서 예외가 발생하면 completionSteps를 null과 직렬화할 수 없는 결과를 전달하여 실행하고 이 단계를 중단합니다.

  5. completionSteps를 serializedResult와 null을 전달하여 실행합니다.

• toolPromise가 이유 r로 거부되었다면 다음과 같이 합니다.

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

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

  3. localExecutions[uuid]가 존재하지 않으면 반환합니다.

  4. localExecutions[uuid]를 제거합니다.

  5. completionSteps를 null과 도구 거부됨을 전달하여 실행합니다.

단언: 이 단계들은 modelContext의 관련 에이전트의 이벤트 루프에서 실행되고 있어야 합니다.

tool map을 modelContext의 내부 컨텍스트의 도구 맵으로 설정합니다.

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

exposed origins를 tool map[tool name]의 노출된 출처로 설정합니다.

tool map[tool name]을 제거합니다.

참고: 도구 등록을 해제해도 이미 해당 도구의 ToolExecuteCallback을 호출한 실행은 취소되지 않습니다. 콜백 자체에서 등록을 해제하는 경우에도 마찬가지입니다. 등록 시점의 signal은 도구의 사용 가능 여부만 제어하는 반면, 실행 시점의 signal은 특정 호출의 수명을 제어합니다.

targetDocument를 modelContext의 관련 전역 객체의 연결된 Document로 설정합니다.

targetDocument가 완전히 활성화된 상태가 아니면 반환합니다.

참고: 도구의 signal이 targetDocument가 해당 탐색 가능 항목에서 제거된 후 중단되면 이러한 상황이 발생할 수 있습니다. 예를 들어 해당 iframe이 제거된 경우입니다. 이 경우 targetDocument에는 노드 탐색 가능 항목이 없으므로 알림을 보낼 다른 문서를 찾을 수 없습니다.

병렬로, 도구 변경을 문서에 알리는 절차를 targetDocument와 exposed origins를 전달하여 실행합니다.

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

global을 this의 관련 전역 객체로 설정합니다.

tool owner를 global의 연결된 Document로 설정합니다.

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

tool owner가 "tools" 기능을 사용할 수 있도록 허용되지 않았다면, "NotAllowedError" DOMException으로 거부된 프로미스를 반환합니다.

tool map을 this의 내부 컨텍스트의 도구 맵으로 설정합니다.

tool name을 tool의 name으로 설정합니다.

tool title을 tool의 title로 설정합니다.

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

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

tool의 description이 빈 문자열이면, "InvalidStateError" DOMException으로 거부된 프로미스를 반환합니다.

stringified input schema를 빈 문자열로 설정합니다.

tool의 inputSchema가 존재하면, stringified input schema를 tool의 값을 전달하여 JavaScript 값을 JSON 문자열로 직렬화한 결과로 설정합니다. inputSchema. 이 과정에서 예외가 발생했다면 해당 예외로 거부된 프로미스를 반환합니다.

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

참고: tool owner가 완전히 활성화된 상태인지 위에서 이미 검사했지만, tool의 inputSchema를 직렬화하면 tool owner가 더 이상 완전히 활성화된 상태가 아니게 만드는 스크립트(예: toJSON() 메서드)가 실행될 수 있습니다. 예를 들어 해당 iframe을 제거하는 경우입니다.

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

참고: 마찬가지로 tool의 inputSchema를 직렬화하는 동안 실행되는 스크립트는 tool name이라는 이름의 다른 도구를 등록할 수 있습니다.

options의 signal이 존재하고 중단된 상태라면, options의 signal의 중단 사유로 거부된 프로미스를 반환합니다.

exposed origins를 빈 목록으로 설정합니다. 이 목록에는 출처가 포함됩니다.

options의 exposedTo가 존재하면 다음을 수행합니다.

1. options의 exposedTo에 있는 origin 각각에 대해 다음을 수행합니다.

   1. parsedURL을 origin에 대해 URL 파서를 실행한 결과로 설정합니다.

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

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

promise를 this의 관련 영역에서 생성된 새로운 프로미스로 설정합니다.

options의 signal이 존재하면 다음을 수행합니다.

1. signal을 options의 signal로 설정합니다.

2. 단언합니다: signal은 중단된 상태가 아닙니다.

3. signal에 다음 중단 단계를 추가합니다.

   1. 도구 등록 해제를 this와 tool name을 전달하여 수행합니다.

   2. signal의 중단 사유로 promise를 거부합니다.

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

결과에 영향을 미치는 작업 힌트

tool의 annotations의 consequentialHint

디버깅

tool의 annotations의 debugging

노출된 출처

exposed origins

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

다음 단계를 병렬로 실행합니다.

1. tool owner와 exposed origins를 전달하여 도구 변경을 문서에 알립니다.

2. global을 전달하여 webmcp 작업 소스에 전역 작업을 대기열에 추가하고, promise를 undefined로 이행합니다.

promise를 반환합니다.

global을 this의 관련 전역 객체로 설정합니다.

toolRequestor를 global의 연결된 Document로 설정합니다.

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

toolRequestor가 "tools" 기능을 사용할 수 있도록 허용되지 않았다면, "NotAllowedError" DOMException으로 거부된 프로미스를 반환합니다.

from origins를 빈 목록으로 설정합니다. 이 목록에는 출처가 포함됩니다.

options의 fromOrigins가 존재하면 다음을 수행합니다.

1. options의 fromOrigins에 있는 origin 각각에 대해 다음을 수행합니다.

   1. parsedURL을 origin에 대해 URL 파서를 실행한 결과로 설정합니다.

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

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

promise를 this의 관련 영역에서 생성된 새로운 프로미스로 설정합니다.

다음 단계를 병렬로 실행합니다.

1. discoveredTools를 빈 목록으로 설정합니다.

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. (tool definition, targetDocument)를 discoveredTools에 추가합니다.

4. global을 전달하여 webmcp 작업 소스에 전역 작업을 대기열에 추가하고, 다음 단계를 실행합니다.

   1. tools를 RegisteredTool 사전의 빈 목록으로 설정합니다.

   2. discoveredTools의 (tool definition, targetDocument) 각각에 대해 다음을 수행합니다.

      1. 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

         targetDocument의 출처를 직렬화한 결과입니다.

         annotations

         tool definition의 주석 정보가 null이 아니면, ToolAnnotations 사전이며, 해당 사전의 readOnlyHint는 tool definition의 주석 정보의 읽기 전용 힌트이고, untrustedContentHint는 tool definition의 주석 정보의 신뢰할 수 없는 콘텐츠 힌트이고, consequentialHint는 tool definition의 주석 정보의 결과에 영향을 미치는 작업 힌트이며, debugging은 tool definition의 주석 정보의 디버깅입니다.

      2. registeredTool을 tools에 추가합니다.

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

   4. promise를 tools로 이행합니다.

promise를 반환합니다.

callerDocument를 this의 관련 전역 객체의 연결된 Document로 설정합니다.

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

callerDocument가 "tools" 기능을 사용할 수 있도록 허용되지 않았다면, "NotAllowedError" DOMException으로 거부된 프로미스를 반환합니다.

expectedTargetOriginURL을 tool의 origin을 파싱한 결과로 설정합니다.

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

expectedTargetOrigin을 expectedTargetOriginURL의 출처로 설정합니다.

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

inputObject가 제공되지 않았다면 inputObject를 OrdinaryObjectCreate(%Object.prototype%)로 설정합니다.

단언합니다: inputObject는 Object입니다.

inputArguments를 inputObject를 전달하여 JavaScript 값을 JSON 문자열로 직렬화한 결과로 설정합니다. 이 과정에서 예외가 발생했다면 해당 예외로 거부된 프로미스를 반환합니다.

promise를 this의 관련 영역에서 생성된 새로운 프로미스로 설정합니다.

targetWindow를 tool의 window로 설정합니다.

targetDocument를 targetWindow의 연결된 Document로 설정합니다.

targetDocument의 노드 탐색 가능 항목이 null이면, "InvalidStateError" DOMException으로 거부된 프로미스를 반환합니다.

uuid를 새로운 고유 내부 값으로 설정합니다.

options의 signal이 존재하면 다음을 수행합니다.

1. signal을 options의 signal로 설정합니다.

2. signal이 중단된 상태라면, signal의 중단 사유로 거부된 프로미스를 반환합니다.

3. traversable을 targetDocument의 노드 탐색 가능 항목의 순회 가능한 탐색 가능 항목으로 설정합니다.

4. signal에 다음 중단 단계를 추가합니다.

   1. signal의 중단 사유로 promise를 거부합니다.

   2. traversable과 uuid를 전달하여 병렬로 대기 중인 도구 실행을 취소합니다.

다음 단계를 병렬로 실행합니다.

1. targetDocument의 노드 탐색 가능 항목의 순회 가능한 탐색 가능 항목이 callerDocument의 노드 탐색 가능 항목의 순회 가능한 탐색 가능 항목과 다르면, callerDocument의 관련 전역 객체를 전달하여 webmcp 작업 소스에 전역 작업을 대기열에 추가하여, "InvalidStateError" DOMException으로 promise를 거부하고, 이 단계들을 중단합니다.

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

2. targetOrigin을 targetDocument의 출처로 설정합니다.

3. callerOrigin을 callerDocument의 출처로 설정합니다.

4. targetOrigin이 expectedTargetOrigin과 동일 출처가 아니면, callerDocument의 관련 전역 객체를 전달하여 webmcp 작업 소스에 전역 작업을 대기열에 추가하여, "NotFoundError" DOMException으로 promise를 거부하고, 이 단계들을 중단합니다.

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

6. toolName을 tool의 name으로 설정합니다.

7. targetToolMap[toolName]이 존재하지 않으면, callerDocument의 관련 전역 객체를 전달하여 webmcp 작업 소스에 전역 작업을 대기열에 추가하여, "NotFoundError" DOMException으로 promise를 거부하고, 이 단계들을 중단합니다.

8. tool definition을 targetToolMap[toolName]으로 설정합니다.

9. targetOrigin, tool definition의 노출된 출처, callerOrigin을 전달하여 도구가 출처에 노출되는지 확인한 결과가 false이면, callerDocument의 관련 전역 객체를 전달하여 webmcp 작업 소스에 전역 작업을 대기열에 추가하여, "NotFoundError" DOMException으로 promise를 거부하고, 이 단계들을 중단합니다.

   참고: 위의 세 가지 검사 모두에서 "NotFoundError"로 거부합니다. 즉, targetOrigin이 expectedTargetOrigin과 일치하지 않거나, toolName이 존재하지 않거나, tool definition이 callerOrigin에 노출되지 않은 경우입니다. 이를 통해 교차 출처 호출자가 조작된 RegisteredTool 사전을 사용하여 targetDocument의 현재 출처를 탐색하거나 callerOrigin에 노출되지 않은 비공개 도구를 열거하지 못하도록 합니다.

10. completionSteps를 문자열 또는 null인 result와 도구 실행 오류 또는 null인 error를 받고 다음 단계를 병렬로 실행하는 알고리즘으로 설정합니다.

    1. 단언합니다: result와 error 중 정확히 하나만 null입니다.

    2. targetDocument의 노드 탐색 가능 항목의 순회 가능한 탐색 가능 항목의 대기 중인 도구 실행 맵[uuid]이 존재하지 않으면 반환합니다.

       uuid로 식별되는 대기 중인 실행이 더 이상 존재하지 않을 수 있습니다. 이는 (a) 호출자 문서가 파괴되거나 호출자가 옵션 신호를 통해 실행을 중단할 때 발생하는 도구 취소와 (b) 도구 프로미스 이행 사이의 경합으로 인해 발생할 수 있습니다. 두 작업 모두 completionSteps를 호출하려고 경합하며, 먼저 호출된 작업이 키 uuid를 사용하여 대기 중인 실행을 제거합니다. 이 검사는 이후에 발생하는 경합 호출로부터 보호합니다.

    3. targetDocument의 노드 탐색 가능 항목의 순회 가능한 탐색 가능 항목의 대기 중인 도구 실행 맵[uuid]을 제거합니다.

    4. error가 null이면, callerDocument의 관련 전역 객체를 전달하여 webmcp 작업 소스에 전역 작업을 대기열에 추가하여, promise를 result로 이행합니다.

    5. 그렇지 않으면, callerDocument의 관련 전역 객체를 전달하여 webmcp 작업 소스에 전역 작업을 대기열에 추가하여, 이름이 error의 대응하는 예외 이름인 DOMException으로 promise를 거부합니다.

       참고: targetDocument에서 발생한 내부 JavaScript 예외 객체나 메시지가 아닌 도구 실행 오류만 전달하면, 제공자의 구현 세부 정보나 스택 추적이 출처 간에 유출되는 것을 방지할 수 있습니다.

11. execution을 다음 항목을 갖는 새로운 대기 중인 도구 실행으로 설정합니다.

    호출자 문서

    callerDocument

    대상 문서

    targetDocument

    도구 이름

    toolName

    완료 단계

    completionSteps

12. targetDocument의 노드 탐색 가능 항목의 순회 가능한 탐색 가능 항목의 대기 중인 도구 실행 맵[uuid]을 execution으로 설정합니다.

13. targetWindow를 전달하여 webmcp 작업 소스에 전역 작업을 대기열에 추가하고, toolName, targetDocument, inputArguments, completionSteps, uuid를 전달하여 도구 실행 단계를 실행합니다.

    참고: 문서는 완전히 활성화된 상태일 때만 이벤트 루프의 작업을 처리하므로, targetDocument가 완전히 활성화된 상태가 아니라면 도구 실행 단계가 대기열에 추가되기만 하며, 문서가 다시 활성화될 때(즉, bf-cache에서 벗어날 때) 실행됩니다.

promise를 반환합니다.

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

단언: traversable의 활성 문서는 완전히 활성화된 상태입니다.

observation을 새로운 관찰로 둡니다.

flat descendants를 자기 자신을 포함한 하위 탐색 가능 항목으로 둡니다. 이는 traversable의 활성 문서에 속합니다.

flat descendants의 각 항목에 대해 반복합니다. 각 탐색 가능 항목 descendant를 처리합니다.

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

2. id를 document의 고유 ID로 둡니다.

3. tools를 document의 연결된 ModelContext의 내부 컨텍스트의 도구 맵의 값으로 둡니다. 이 값은 도구 정의입니다.

   참고: 이 단계들은 AI 에이전트 대기열에서 각 병렬로 실행되며, 각 Document의 관련 에이전트의 이벤트 루프와 병렬로 실행되지만, 구현에서는 각 도구 맵에 대한 접근을 프로세스 간 통신이나 잠금을 통해 동기화하여 부분적으로 갱신된 상태가 관찰되지 않도록 합니다.

4. observedToolCollection을 새로운 관찰된 도구 모음으로 두고, 다음 항목을 포함하도록 합니다.

   출처

   document의 출처

   도구

   tools

5. observation의 도구 맵[id]을 observedToolCollection으로 설정합니다.

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

observation과 구현 정의 단계를 수행합니다. 이때 브라우저 에이전트와 함께 처리하여 observation의 도구 맵을 브라우저 에이전트가 허용하는 방식으로 노출합니다.

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