Function planToolPaths

packages/plugins/openapi/src/sdk/definitions.ts:246–284

(inputs: readonly OperationPathInput[])

 * The returned `operationIndex` points back into the `inputs` array.
 */
export const planToolPaths = (inputs: readonly OperationPathInput[]): PlannedToolPath[] => {
  const raw: RawToolPath[] = inputs.map((op, index) => {
    const operationId = op.operationId;
    const operationHash = stableHash({
      method: op.method,
      path: op.pathTemplate,
      operationId,
    });
    const versionSegment = deriveVersionSegment(op.pathTemplate);

    if (op.explicitToolPath) {
      const [group = "root", ...leafParts] = op.explicitToolPath.split(".").filter(Boolean);
      const leaf = leafParts.join(".") || group;
      return {
        toolPath: op.explicitToolPath,
        group,
        leaf,
        versionSegment,
        method: op.method,
        operationHash,
        operationIndex: index,
      };
    }

    const group = normalizeGroupSegment(op.tag0) ?? derivePathGroup(op.pathTemplate);
    const leaf = deriveLeaf(operationId, op.method, op.pathTemplate, group);
    return {
      toolPath: `${group}.${leaf}`,
      group,
      leaf,
      versionSegment,
      method: op.method,
      operationHash,
      operationIndex: index,
    };
  });

  return resolveCollisions(raw).sort((a, b) => a.toolPath.localeCompare(b.toolPath));
};

/**
 * Compile extracted operations into tool definitions with structured